Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Enterprise Open source

Configure panel options

A Grafana panel is a visual representation of data that you can customize by defining a data source query, transforming and formatting data, and configuring visualization settings.

A panel editor includes a query builder and a series of options that you can use to transform data and add information to your panels.

This topic describes how to:

  • Open a panel for editing
  • Add a panel title and description
  • View a panel JSON model
  • Configure repeating rows and panels

Edit a panel

After you add a panel to a dashboard, you can open it at any time to change or update queries, add data transformation, and change visualization settings.

  1. Open the dashboard that contains the panel you want to edit.

  2. Click in the panel title and select Edit. To use a keyboard shortcut to open the panel, hover over the panel and press e.

    The panel opens in edit mode.

Add a title and description to a panel

Add a title and description to a panel to share with users any important information about the visualization. For example, use the description to document the purpose of the visualization.

  1. Edit a panel.

  2. In the panel display options pane, locate the Panel options section.

  3. Enter a Title.

    Text entered in this field appears at the top of your panel in the panel editor and in the dashboard.

  4. Write a description of the panel and the data you are displaying.

    Text entered in this field appears in a tooltip in the upper-left corner of the panel.

    You can use variables you have defined in the Title and Description field, but not global variables.

View a panel JSON model

Explore and export panel, panel data, and data frame JSON models.

  1. Open the dashboard that contains the panel.

  2. Click in the panel title and select Inspect > Panel JSON.

  3. In the Select source field, select one of the following options:

    • Panel JSON: Displays a JSON object representing the panel.
    • Panel data: Displays a JSON object representing the data that was passed to the panel.
    • DataFrame structure: Displays the data structure of the panel, including any transformations, field configurations, and override configurations that have been applied.
  4. To explore the JSON, click > to expand or collapse portions of the JSON model.

Configure repeating panels

You can configure Grafana to dynamically add panels or rows to a dashboard. A dynamic panel is a panel that the system creates based on the value of a variable. Variables dynamically change your queries across all panels in a dashboard. For more information about repeating rows, refer to Configure repeating rows.

Note: Repeating panels require variables to have one or more items selected; you cannot repeat a panel zero times to hide it.

To see an example of repeating panels, refer to Prometheus dashboard with repeating panels.

Before you begin:

  • Ensure that the query includes a multi-value variable.

To configure repeating panels:

  1. Edit the panel you want to repeat.

  2. On the display options pane, click Panel options > Repeat options.

  3. Select a direction.

    • Choose horizontal to arrange panels side-by-side. Grafana adjusts the width of a repeated panel. Currently, you cannot mix other panels on a row with a repeated panel.
    • Choose vertical to arrange panels in a column. The width of repeated panels is the same as the original, repeated panel.
  4. To propagate changes to all panels, reload the dashboard.