Sysdig Documentation

Using New Dashboard

Notice

Support for New Dashboards is in Beta.

Sysdig Monitor supports both form-based and PromQL-based queries. You simply run a query and Sysdig Monitor builds a Dashboard that you can customize according to your preferences.

To create a Dashboard:

  1. Build either a simple query or an advanced.

  2. Define right and left Y-axes.

  3. Define legend.

  4. Set up Panel title and description.

Building a Simple Query

  1. On the Dashboards tab, click Add dashboard.

    add-dashboard.png
  2. Click Beta Dashboard.

    Clicking Beta Dashboard opens a default beta dashboard for the avg(avg(cpu.used.percent)) metrics.

  3. Select a metric as follows:

    run-query.png

    Specify Time Aggregation and Group Aggregation.

  4. Specify the display text in the Display field.

    The text appears as a title for the legend:

    display-legend.png
  5. Specify an appropriate segmentation:

    segmentation.png

    You can enter the number of entities and the order in which they are displayed in the legend.

  6. Specify the scope for the dashboard you are creating.

    scope-promql-dashboard.png

    You can either choose to inherit the dashboard scope as it is or apply the scope to only a set of selected entities.

  7. Specify the unit of scale and the display format for Y-Axis.

    Unit-Y-Axis.png
  8. Optionally, compare the data against historical data.

    compare_to.png

    When segmentation is applied, comparing metrics against historical data is not supported.

  9. Select the appropriate time presets from the Time Navigation.

Building an Advanced Query

The Advanced Query field currently supports running only PromQL queries.

  1. On the Beta Dashboard screen, do one of the following:

    • Click Add Dashboard if no panels exist in the Dashboard.

    • Click Add Panel if you are adding a new panel to the Dashboard.

  2. Click the Advanced Query button.

    adv_query.png

    The Advanced Query panel appears.

  3. Enter the query as follows:

    adv_promql_query.png

    In this example, the rate of memory heaps released in bytes in an interval of 5 minutes is calculated and then the total rate is calculated in each Kubernetes cluster.

  4. Select the desired time window.

    window-promql.png
  5. Specify a descriptive title for the legend and a name for the time series.

    descriptive_title.png

    You can specify a variable as shown in the image. The variable name is replaced with the Kubernetes cluster names in the legend.

  6. Specify the unit for incoming data and how the data should be displayed.

    incoming_display.png

    For example, you can specify the incoming data to be gathered in kilobytes and displayed as megabytes.

    Also, determine the location of the Y-Axis on the graph. When you have additional queries, the flexibility to place an additional Y-axis on the graph comes in handy.

  7. Click Save to save the changes.