Contact UsGet started
© 2025 Direct Cursus Technology L.L.C.

Adding a widget to a dashboard

Written by
Updated at September 3, 2025

Dashboards are visual panels that allow you to quickly assess the status and performance of your cloud resources. You can use ready-made dashboards offered by various services or create your own one.

A dashboard consists of widgets that allow displaying various types of information: a chart, alert, or escalation. There are also widgets that help you organize information on a dashboard, i.e., a title, text, and section.

Adding a widget to a dashboard involves the following steps:

  1. Open a dashboard or create a new one.
  2. At the top right, click and select the widget you want to add.
  3. Specify the widget settings.
  4. Click Save at the top right.

You can move widgets around the dashboard and resize them.

Chart

A chart allows you to visualize metric changes over time. You can configure charts on the dashboard or add them from the Metrics section.

  1. Click Graph.
  2. Configure the chart by specifying queries and visualization of metrics.
  3. Optionally, add parameters and configure chart repetition.
  4. Click Save.

Chart parameters

The steps you take to configure charts on the dashboard or in the Metrics section are the same.

To configure a chart:

  1. Click near the chart and select Edit.

  2. At the top right of the chart panel, click Settings.

  3. Set the chart parameters listed below.

    The parameters you enter will apply to the chart immediately so you do not need to save them.

  4. Close the side panel after you complete the configuration.

Thresholds

Use this setting to display lines for critical or target values. You can set the thresholds in the chart settings menu or update the JSON file:

  1. Under Thresholds, click Add threshold.
  2. Specify a numeric value for the threshold. To specify a fractional value, use the dot as the decimal separator, e.g., 9.75.
  3. Select the threshold color.
  4. Enable or disable Show on graph. This option applies to all thresholds.

  1. At the top of the dashboard, click Settings.

  2. Select JSON.

  3. In the widget parameters, update the values in the thresholds section.

    "widgets": [
  ...
  "thresholds": {
            "items": [
              {
                "color": "#d63232",
                "value": 9.75,
                "_value": "value"
              },
              ...
              {
                "color": "#92db00", // Basic threshold
              }
            ],
            "showMode": "CONSTANT_LINE" 
  }

    Note

    Thresholds must have a basic value, which is set in the items element without value. All other thresholds must have a numeric value.

  4. Click Apply.

You can add a link to an external resource or dashboard.

  1. Under Links, click Add a link.

  2. Enter the link title to display on the chart.

  3. Select External link and enter the link text in http(s)://<address> format. You can add a link to any website or an external resource.

  4. Select Dashboard and specify:

    1. Cloud and folder where the dashboard resides. The list contains all clouds and folders you have access to.
    2. Dashboard to open via the link.
    3. Share timeframe. The chart will share the timeframe of the source chart.

  5. Enable or disable the Open in new tab option.

    The links you add will appear in the top right chart in the menu.

Alert

Use the alert widget to display the current alert status on a dashboard. To add such widget to a dashboard, create an alert first.

  1. Click Alert.
  2. Select an alert from the list and enter a title for it.
  3. Click Save.

Escalation

Note

Escalations are at the Preview stage and subject to the following limitations:

  • Maximum concurrent escalations: 10
  • Maximum active calls: 1
  • Maximum calls per minute: 5
  • Maximum calls per calendar month: 10

To change these limitations, contact support.

This dashboard widget displays running escalation instances from the same escalation policy. To add such widget to a dashboard, create an escalation policy first.

  1. Click Escalation.
  2. Enter a title for the escalation.
  3. Select an escalation policy from the list.
  4. Optionally, specify whether the dashboard should display all escalations or only those currently running.
  5. Optionally, enter the maximum number of escalations that can be displayed on the dashboard.
  6. Click Save.

Text

Use this widget to add a text comment to a dashboard. It supports text formatting, lists, headers, cuts, links, code blocks, images, and other elements.

  1. Click Text.
  2. Enter text in the input field. Format the text as needed.
  3. To add a link, image, code block, or another element, click and select the item you need.
  4. To enter text in Markdown format, click and select Markdown markup.
    To exit the markup mode, click and select Visual editor.
  5. Click Save.

Title

Titles allow you to visually separate widgets on a dashboard.

  1. Click Heading.
  2. Enter text in the input field.
  3. Select the title size. There are four available title levels.
  4. Click Save.

Section

A section allows you to group widgets on a dashboard and hide widget groups.

  1. Click Section.
  2. Drag widgets to the section.
  3. Click next to the section name and specify:
    1. Section name: Enter a name.
    2. Section state: Select whether to collapse or expand the section by default.
    3. Repeat by: Select a parameter to add sections with charts for each of its values.
    4. Click Save.
  4. Click Save.

To share a section, click next to the section name. A link to the section will be copied to the clipboard.

See also

Previous
Copying dashboards
Next
Adding a dashboard parameter