opensource/grafana
1
0
Fork 0
mirror of https://github.com/grafana/grafana.git synced 2025-09-27 07:54:17 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
grafana/docs/sources/panels-visualizations/configure-panel-options/index.md
Christopher Moyer 414d536186 Docs: refactors config panels and visualizations, corrects relrefs (#55940) 
* refactors config panels and visualizations, corrects relrefs

* adds an alias

* Remove some old content

* moves visualizations topic to the root

* moves out panels and visualization topics to the root

* adds move and resize panel to add/organize panel; creates a create dashboard topic under build dashboards; adjusts context of add a panel to be from within an existing dashboard

* updates aliases

* creates search at root, moves dashboard preview to search, creates standalone search dashboard topic

* moves Set dashboard time range to use-dashboards, creates modify dashboard settings and adds moves Modify dashboard time settings to that topic

* moves existing query-options topic from working with panels to configure-panel-visualizations, moves panel time overrides and timeshift content to query options

* Moving things to better category, fixing links, improving ordering

* Move panel inspector to main panel topic

* completes partial fix of relrefs

* relref fixes con't

* restructures remaining panels topics

* more relref fixes

* Minor fix

* Minor tweak

* finishes fixing relrefs

Co-authored-by: Torkel Ödegaard <torkel@grafana.com>
Co-authored-by: Jack Baldry <jack.baldry@grafana.com>
2022-10-11 15:31:20 -05:00

4.3 KiB
Raw Blame History

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

Configure panel options

A Grafana panel is the user interface you use to define a data source query, and transform and format data that appears in visualizations.

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
  • Add repeating rows and panels

Edit a panel

After you add a panel to a dashboard, you can open it at any time to change 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]({{< 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. 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 raw result set with transformations, field configurations, and override configurations 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.