OBSERVABILITY PLATFORM
Panels

Visualize dashboard contents with panels

This feature isn't available to all Chronosphere Observability Platform users and might not be visible in your app. For information about enabling this feature in your environment, contact Chronosphere Support.

Panels allow you to visualize, filter, and transform the results of a query. Standard dashboards provide visualizations designed to work with other Chronosphere Observability Platform features, such as Metrics Explorer.

Panels react to the time range set on a dashboard and can be dynamically customized through the use of dashboard variables.

Classic dashboards have their own panels and methods of configuring them. For details about panels in classic dashboards, see Classic dashboard panels.

Common panel elements

All panels share common elements.

  • Name: The panel's configured name.
  • Content: The results of the panel's query visualized through the selected panel type.
  • Links: An icon that reveals any links configured for the panel.
  • Expand: Expands the panel to a the full width and height of the browser for a more detailed view.
  • Options: Opens a menu of panel-editing actions. This menu also provides a link to explore the panel's queries in Metrics Explorer.

As you hold the pointer over a point of time in a visualization, each other panel in the dashboard indicates that same point of time to help you identify possible correlations.

If the panel is a time series visualization, you can click and drag across the content to select the dashboard's time range.

When a dashboard is in editing mode, Observability Platform reveals additional elements:

  • Editing tools: A series of icons for editing, duplicating, deleting, and reorganizing panels in a panel group.
  • Resizing handle: A handle in the panel's corner for changing its size within a panel group.

Visualization panels can also add additional elements.

  • Tooltip: Details about the series under the cursor. You can pin the tooltip in place by clicking the visualization, and you can focus on a series by selecting it in the tooltip.
  • Legend: If configured, the panel can include a legend that identifies series in the visualization.

Add panels to a dashboard

To add and use panels in a dashboard, you must first create a dashboard or select an existing dashboard to which you'll add the panel.

Each panel on a dashboard belongs to a panel group. If a dashboard doesn't have any panel groups, Observability Platform creates one for you when you add a panel.

To add a panel to a standard dashboard with no panel groups:

  1. Open the dashboard. You can view a list of all dashboards or select from a list of dashboards in a collection.
  2. Click Edit on the dashboard.
  3. Click Panel.
  4. In the Add Panel interface that appears, provide a name for the new panel.
  5. Click Add to add the panel or Cancel to discard it.

To add a new panel to a panel group:

  1. In the panel group to which you want to add a panel, click the Add panel to group icon.
  2. In the Add Panel interface that appears, provide a name for the new panel.
  3. Click Add to add the panel or Cancel to discard it.

Panels aren't permanently added to a dashboard until you save all changes to the dashboard by clicking Save on the dashboard.

For details about all of the settings in a panel, see Edit a panel. You can save a new panel to a dashboard with as little as a name, then edit it later to configure it and add or modify queries.

Edit a panel

You can customize the features of each panel on a dashboard and edit the queries used to populate it, if necessary.

All panels consists of common settings and features:

  • Name: The panel's name as displayed with the panel.
  • Group: The panel group that contains the panel.
  • Description: A description of the panel displayed when holding the pointer over an Information icon.
  • Type: The type of visualization presented in the panel.

Panels can also have additional options presented in tabs of the Edit panel interface. Most panels provide these tabs:

  • Query: Queries whose results Observability Platform uses to populate the panel's visualization.
  • Settings: Configuration options for the selected panel type.
  • Links: Links associated with the panel, which can optionally use variables provided by Observability Platform related to the panel or dashboard.
  • JSON: An editable, automatically updated JSON representation of the panel's configuration.

For details on these settings or unique features in a panel type, see its documentation. The panel types available for visualizing data include:

  • Time Series Chart: A line or bar chart representation of time series data returned by the panel's queries.
  • Bar Chart: A bar chart representation of data returned by the panel's queries.
  • Gauge Chart: A value for each data point returned by a query, visualized as a configurable gauge depicting a minimum and maximum range and configurable thresholds.
  • Heat Map: The density of data points across ranges of values returned by a query, visualized by colors that represent the magnitude of data for each range of values.
  • Table: Presents the data returned by the query as a customizable table.

Additional panel types unrelated to the results of a query include:

  • Markdown: Renders the given Markdown text.

To edit a panel on a standard dashboard:

  1. Open the dashboard. You can view a list of all dashboards or select from a list of dashboards in a collection.
  2. Click Edit for the dashboard.
  3. Click Edit on the panel you want to edit.
  4. In the Edit panel interface that appears, modify the panel's settings.
  5. Click Apply to apply the changes or Cancel to discard them.

After you've finished editing panels, click Save on the dashboard to save your changes.

Change a panel's type

A panel's type defines its visualization method or content. By default, a new panel is of the Time Series Chart type.

To change a panel's type:

  1. Open the panel's editor.
  2. Click the Type dropdown.
  3. Select a panel type.
  4. Click Apply to save any panel type changes and exit the panel editor.

Change a panel's query

Queries populate panels with data to visualize.

To change a panel's query:

  1. Open the panel's editor.

  2. In the Query tab, enter PromQL expressions in line-numbered field for the query you want to edit.

    The visualization preview changes as you edit the query. If the query doesn't return any data, the visualization preview doesn't indicate any changes. If the query or results return an error, an icon appears next to the panel name.

  3. Optional: Add a Series alias to define the name displayed for the series in the panel's tooltip and legend.

  4. Optional: Add additional queries by clicking Add query.

  5. Optional: Hide a visualized query by clicking Hide query, or show a hidden query by clicking Show query.

  6. Optional: Configure the type of query by selecting one from the Query type dropdown.

  7. Click Apply to save any query changes and exit the panel editor.

For details about writing queries, read the querying documentation.

You can use dashboard variables in a query to let dashboard users dynamically customize them without modifying the query itself.

If you include a dashboard variable that doesn't exist, Observability Platform notifies you of the missing variable in the query editor and includes a link of the variable name that automatically creates and configures the suggested variable.

Exit the panel editor

To save changes to a panel and exit the panel editor, click Apply.

To exit the panel editor without saving changes, click Cancel.

Save changes to a dashboard

Changes made to panels in a dashboard aren't saved until you save all changes to the dashboard, even after applying the changes to the panels in the Edit panel interface.

To save changes to a dashboard's panels and layout from the dashboard view, click Save.