Documentation

    Status

    Status calculates a value from source rows and turns it into a labeled state using thresholds you set: good, warning or needs attention.

    Report website response time

    The website's response time of 0.8 seconds is under the 1 second threshold set for good, so the visual reads On track.

    The live example needs a desktop screen. The result it produces is shown here, and the explanation and settings below work on any screen.

    Result
    ServiceResponse seconds
    Website0.8
    1. Read the visual: 0.8 s is under the good threshold of 1, so it reads On track.
    2. Expand Goal in the Data tab and lower Good up to below 0.8. The state changes.
    3. Open the Design tab and expand Status colors to change the colors.

    When to use

    Use Status when readers need to know whether to act more than they need the exact figure. Use Gauge or Progress when they also need to see how far the value is from the limit.

    Inputs

    1 port
    Table

    Accepts: Tables.

    Accepts one connection on this port.

    Settings

    Value

    Field to calculate. Automatic picks one, and Count rows needs none.

    Operation

    How the source rows become one value. Missing values are skipped.

    Default: Sum

    Options: Sum, Average, Median, Minimum, Maximum, 25th percentile, 75th percentile, 90th percentile, 95th percentile, Percentile, First by time, Last by time, Count values, Count distinct, Count rows, Count true, Percentage true.

    Label

    Text of the label.

    37 more settings
    Source timezone

    IANA time zone for timestamps without an offset, such as Europe/Copenhagen. Ambiguous local times need an explicit offset.

    Default: UTC

    Chart timezone

    IANA time zone used for grouping and display. Vista filters keep their own time zone.

    Default: UTC

    Week starts

    Day the week starts on.

    Default: Monday

    Options: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday.

    Fiscal year starts

    Month the fiscal year starts in. Sets quarter and year boundaries.

    Default: January

    Options: January, February, March, April, May, June, July, August, September, October, November, December.

    Show tooltip

    Shows or hides values when you hover over a mark.

    Default: true

    Content

    Use the automatic details, or write your own text with calculated values.

    Default: Automatic

    Options: Automatic, Custom.

    Goal

    Whether higher, lower or staying inside a range is good.

    Default: Higher is better

    Options: Higher is better, Lower is better, Within a range.

    Good from

    With Higher, values from here up are good. With Lower, values up to here are good.

    Default: 80

    Warning from

    With Higher, values from here up get a warning. With Lower, values up to here get a warning.

    Default: 50

    Horizontal alignment

    Alignment of the content.

    Default: Center

    Options: Left, Center, Right.

    Vertical alignment

    Vertical position of the content in the card: top, center or bottom.

    Default: Center

    Options: Top, Center, Bottom.

    Status text size

    Size of the status text.

    Default: 28

    Label size

    Size of the label.

    Default: 12

    Value color

    Color of the value.

    Label color

    Color of the label.

    Show value

    Shows or hides the value.

    Default: true

    Show label

    Shows or hides the label.

    Default: true

    Content spacing

    Space between the parts of the card, in pixels (0-80).

    Default: 6

    Show status text

    Hides the text. Thresholds and status colors still apply.

    Default: true

    Actual value size

    Auto (0) matches Label size. Otherwise 10-160 pixels.

    Default: 0

    Number format

    Percentage shows fractions multiplied by 100. Calculations keep the original units.

    Default: Automatic

    Options: Automatic, Number, Percentage.

    Decimals

    Number of decimal places.

    Default: 0

    Digit grouping

    Groups digits, so 2630 shows as 2,630.

    Default: true

    Prefix

    Text before the value.

    Suffix

    Text after the value. Adding % doesn't multiply the value by 100.

    Scale

    Display unit for the value.

    Default: none

    Options: none, K, M, B.

    Presentation

    How the status is shown.

    Default: Single indicator

    Options: Single indicator, Traffic lights.

    Indicator size

    Auto (0) gives 20-pixel lights, or a dot half the size of the status text. A set size can be 8-120 pixels.

    Default: 0

    Background

    Card background color. Auto follows the theme.

    Good label

    Text for the good status.

    Default: On track

    Warning label

    Text for the warning status.

    Default: Watch

    Needs attention label

    Text for the needs-attention status.

    Default: Needs attention

    Good color

    Color for the good status.

    Warning color

    Color for the warning status.

    Needs attention color

    Color for the needs-attention status.

    Corner radius (px)

    Corner radius in whole logical pixels.

    Default: 0

    Border width (px)

    Border width in whole logical pixels.

    Default: 0

    Status FAQs

    How do I set whether high or low is good?
    Under Goal, choose the direction and thresholds.
    Is the value still shown?
    Yes. The state appears with the value below it.

    Chart your data. Build it in Vista.

    Vista opens in your browser, with no account.