opensource/grafana
1
0
Fork 0
mirror of https://github.com/grafana/grafana.git synced 2025-07-31 03:42:39 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
grafana/docs/sources/panels-visualizations/configure-panel-options/index.md
Isabel 337ffd3015 docs: improvements to visualizations docs (#69503) 
* made changes from PR 67118

* made changes from PR 67123

* made some changes from PR 67128

* made changes from PR 67129

* made changes from PR 67133
2023-06-07 11:28:37 -04:00

4.5 KiB
Raw Blame History

aliases keywords menuTitle title weight
../panels/add-panels-dynamically/
../panels/configure-panel-options/
../panels/repeat-panels-or-rows/
../panels/working-with-panels/add-title-and-description/
../panels/working-with-panels/view-json-model/
panel
dynamic
add
title
description
JSON model
Configure panel options Configure panel options 2

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. Hover over any part of the panel to display the actions menu on the top right corner.

  3. Click the menu and select Edit.

    Panel with menu displayed

    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]({{< relref "../../dashboards/variables/" >}}) in the Title and Description field, but not [global variables]({{< relref "../../dashboards/variables/add-template-variables/#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. Hover over any part of the panel to display the actions menu on the top right corner.

  3. Click the menu and select Inspect > Panel JSON.

  4. 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.

  5. 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.

{{% admonition type="note" %}} Repeating panels require variables to have one or more items selected; you cannot repeat a panel zero times to hide it. {{% /admonition %}}

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.