Understanding status widgets
Status widgets show current performance or current performance relative to a known baseline.
 
Figure 34: Status widget thresholds
 
There are important differences to be aware of when looking at a status widget.
1. Know whether you are looking at a status widget showing actual current performance or a widget showing current performance relative to a baseline. Each data field shown is one of these types (performance or baseline performance). Inspect the widget in the Widget Library.
2. Be aware of the From/To time frame for the entire dashboard because all widgets—and especially baseline widgets—are based on this time frame (and the number of data periods) in the time frame.
3. Baseline status widgets show a numeric value, but whether that value is blue, yellow, or red is determined by the percentage difference in the variance from the baseline value.
4. Performance widgets are also blue, yellow, or red, but their status is determined by whether the current value is higher or lower than the threshold value for that category. This is a subtle but important distinction between performance widgets and baseline widgets.
 
Figure 35: Status widgets are interactive
Apex widget in actionApex widget in action
 
When a status widget combines multiple data fields, the status shown is for the worst-performing component. For example, consider a status widget for an application. That application is really comprised of a database, some middleware, and several servers. Each one of those components has its own status. If any one of them shows a yellow or red status, then the top-level application status will also show yellow or red based on the worst performing component. In case there are multiple statuses that are equally bad, then the top-level status shows the worst of the worst. This is so you know where to focus your attention first.
Status widgets can report both Summary and By Time data in the same widget. This means you are viewing current values for the reporting period you select, along with individual values that were observed during the reporting period. For example, your current value shows a network delay of 148.7 milliseconds, which is a blue color because it is below the threshold. The individual values can be clicked for more information. You can also use a click-and-drag operation to select multiple individual values and re-run the dashboard with this new time selection. See Figure 35.
Tip! When upgrading to Apex 17.3.0.0 or greater, any existing status widgets you might have are automatically converted to the new status widget design.
At any time, you can change the widget you are viewing to a different type. Clicking the widget change icon shows a menu of widgets, and another click changes the widget to your new choice (Figure 36). This allows you to visualize the same widget data in a different way depending on your needs—without requiring edits to the actual widget or rerunning the dashboard. For example, by changing widgets you can change a graph to appear as a table instead. Theses changes are temporary and for viewing only, meaning your changes never affect the underlying widget. Plus the choices shown depend on the underlying type of widget and the data within. Changing widgets in this manner is also instantaneous and does not require rerunning the dashboard.
 
Figure 36: Change widgets on-the-fly
Apex widget changing on-the-flyApex widget changing on-the-fly
 
When no current value is available for a status widget data field, the widget displays a “No data” message. For baseline data fields in a status widget, if there is a current value but no baseline is available, the widget appears grayed out with the current value also shown as gray. If a status widget’s current value and its threshold data are zero (0), the widget will either be blue or red depending on the “above” or “below” threshold setting.