About the Dashboard UI

Widgets

Dashboards support time series (Timechart), Histogram, Number graphs, Table, Text, and Toplist.

Timechart, Number and Toplist graph support both form-based and advanced (PromQL) queries, whereas Histogram only support form-based queries. Form-based Number, Table, Histogram, and Toplist panels can show either the latest value for an entity or the entire range of values.

Time Navigation

Dashboard is designed around time. After a query has been executed, Sysdig Monitor polls the infrastructure data every 10 seconds and refreshes the metrics on the Dashboard panel. You select how to view this gathered data by choosing a Preset interval and a time Range. For more information, see Time Navigation.

Panel Properties

• Query
• Axes
• Legend
• Panel

Query

With the Dashboard, you can construct queries in two ways: Form-Based and PromQL. As you construct your query and type in a keyword in the Metrics field, auto-complete offers suggestions for the metrics in the query.

Form-Based Query

Use the UI fields to construct queries. Form-based data queries consist of one metric with time and group aggregation, Segmentation, Display, Unit for both incoming data as well as displaying data on the Y-Axis, and Scope.

PromQL Query

The PromQL field supports only PromQL queries. Enter a PromQL query as follows:

Each query starts with a group aggregator, followed by a time aggregator, then the metrics and segmentation. For example:

topk(10,avg(avg_over_time(sysdig_program_cpu_cores_used{$__scope}[$__interval])) by (program_name, container_name))

Alternatively, you can build a form-based query and translate it to PromQl by using the Translate to PromQL option.

For more information, see Build PromQL Panels from Form Query.

Scope variables

You can configure scope variables at the dashboard level to quickly filter metrics based on Cluster, Namespace, Workload, and more.

When using PromQL queries, you can select the scope by using dynamic variables. This configuration is significant when troubleshooting as it allows you to switch context quickly without reconfiguring queries.

You can use $__scope within a PromQL query to apply a selected scope. It allows you to apply the whole scope instead of applying each scope variable individually to the query. See using $__scope.

For more information, see Reserved Variables.

Smart Autocompletion and Syntax Highlighting

Autocomplete suggests metrics, operators, and functions, while syntax highlighting helps highlight problems within a PromQL query. This is invaluable in dynamic environments and allows you to craft the right queries faster.

Define Axes

Sysdig Monitor provides the flexibility to add two Y-axes on the graph. You can also determine whether you want to use them at all. Having the option to add an extra Y-axis help when you decide to add an extra query.

Specify the following for both Y-Axis and Y-Axis Right:

• Show: Select to show the Y-Axis on the graph.
• Scale: Specify the scale in which you want the data to be shown on the graph.
• Unit: Specify the unit of scale for the incoming data.
• Display Format: Specify the unit of scale for the data to be displayed on the Y-Axis.
• Y-Max: Specify the highest value to be displayed on the Y-Axis. Consider this as the highest point on the range. You can specify the limits as numeric values. However, the type of values that you specify must match the type of values along the axis. Y-Max should be always greater than Y-Min.
• Y-Min: Specify the lowest value to be displayed on the Y-Axis. Consider this as the lowest point on the range. You can specify both limits or you can specify one limit and let the axes automatically calculate the other.

Event Overlay

Examine events directly on the dashboard panels and correlate anomalies and issues with the events. The height of the event bucket is proportional to the number of events and the color indicates the highest severity of the events present.

Define Legend

Determine whether you want a legend with a descriptive label for each plotted time series. Specify the location and layout. Determine the value to be displayed should be the most recently calculated data.

For the labels, the legend uses the text you have specified in the Query Display Name and Timeseries Name fields.

Enable Show to show the legend or create a legend if one does not exist.

Right positions the legend in the upper right corner of the panel. Bottom positions the legend in the lower-left corner of the panel.

Define Panel

Specify the Panel heading and description by using the Panel tab. The description you enter appears as the panel information as follows:

Full Screen view

To view the current dashboard in full-screen mode, Click the Settings (three dots) icon for the dashboard, and select the Full Screen option. To exit full-screen mode, either press the ESC keyboard key or click the Exit (cross) icon.