Asset & Signal Statuses¶

Asset Status are helpful andon-style indicators of an asset's health. They can be used to quickly allow a user to determine the health of assets across large fleets. Status changes are based on rules associated to signals in the asset's data pipeline. These signal statuses roll-up to the Asset (see below for more details). Asset statuses are calculated real-time (in the moment). Although there is no specify asset status history itself, all signal rule state changes are recorded to the asset's Event Log to understand what has been ongoing.

Calcuating Status¶

To calculate the overall asset status, all signals with rules are considered. The order of severity for states is the following:

---
config:
  theme: neutral
---
graph
  Asset@{ shape: rect, label: "Asset Status:<br>Warning" }
  style Asset fill:#fdd835,stroke:#fdd835,fill-opacity:0.2

  Signal@{ shape: das, label: "Signal 1" }
  Signal2@{ shape: das, label: "Signal 2" }
  Signal3@{ shape: das, label: "Signal 3" }

  Rule{Rule};
  style Rule stroke-width:3px,stroke:#fdd835

  Rule{Rule<br>Threshold} -.-  Signal
  RuleT{Rule<br>Timeout} -.- Signal
  Rule2{Rule<br>Threshold} -.- Signal2
  Rule3{Rule<br>Matching} -.- Signal3

  Asset -.- Signal1_Status[Signal Status:<br>Warning] -.- Rule
  Signal1_Status -.- RuleT 
  Asset -.- Signal2_Status[Signal 2 Status:<br>OK] -.- Rule2 
  Asset -.- Signal3_Status[Signal 3 Status:<br>OK] -.- Rule3

  style RuleT stroke-width:3px,stroke:#0ac410
  style Rule2 stroke-width:3px,stroke:#0ac410
  style Rule3 stroke-width:3px,stroke:#0ac410

  style Signal1_Status fill:#fdd835,stroke:#fdd835,fill-opacity:0.2
  style Signal2_Status fill:#0ac410,stroke:#0ac410,fill-opacity:0.2
  style Signal3_Status fill:#0ac410,stroke:#0ac410,fill-opacity:0.2

  %%Actions ~~~ AC@{ shape: brace-l, label: "Triggers any Action functions attached to Rule" }

Severity Precedence

The status calculation severity level order of operations is as follows

• Error Critical Warning Normal
• The most severe level is used as the overall asset status.
• If there are no severity levels above Normal, then the default status for an asset is Normal or Ok .
• In cases where signals do not have a rule configured that determines signal status, dashboard panels use a default blue color instead of showing status.

Timeouts

If any timeout rule on a signal has detected the signal to be timed out, the signal and therefore the overall Asset status is in Timeout . The timeout state may be shown as any of the following.

• All grey icon
• Greyed out list item background
• Timer Icon
• Slightly transparent icon showing last known severity state

---
config:
  theme: neutral
---
graph
  Asset@{ shape: rect, label: "Asset Status:<br>Timeout" }
  style Asset fill:#999,stroke:#fdd835,fill-opacity:0.2

  Signal@{ shape: das, label: "Signal 1" }
  Signal2@{ shape: das, label: "Signal 2" }
  Signal3@{ shape: das, label: "Signal 3" }

  Rule{Rule};
  style Rule stroke-width:3px,stroke:#fdd835

  Rule{Rule<br>Threshold} -.-  Signal
  RuleT{Rule<br>Timeout} -.- Signal
  Rule2{Rule<br>Threshold} -.- Signal2
  Rule3{Rule<br>Matching} -.- Signal3

  Asset -.- Signal1_Status[Signal Status:<br>Timeout] -.- Rule
  Signal1_Status -.- RuleT 
  Asset -.- Signal2_Status[Signal 2 Status:<br>OK] -.- Rule2 
  Asset -.- Signal3_Status[Signal 3 Status:<br>OK] -.- Rule3

  style RuleT stroke-width:3px,stroke:#999
  style Rule2 stroke-width:3px,stroke:#0ac410
  style Rule3 stroke-width:3px,stroke:#0ac410

  style Signal1_Status fill:#999,stroke:#fdd835,fill-opacity:0.2
  style Signal2_Status fill:#0ac410,stroke:#0ac410,fill-opacity:0.2
  style Signal3_Status fill:#0ac410,stroke:#0ac410,fill-opacity:0.2

  %%Actions ~~~ AC@{ shape: brace-l, label: "Triggers any Action functions attached to Rule" }

Where Status is Available¶

Asset and Signal statuses are visible in:

• Asset Fleet Grid / Group / List views
• Some Dashboard Panels that display assets
• Dashboard Panels that show Signals (typically configurable)
• Map views of assets
• Event logs
• Conditions
• Email and SMS notifications
• Action functions are triggered by rule state change events, with the signal status level a part of the payload.

Status Visualization¶