Files
Isabel 91784076c7 Docs: add dashgpt information (#77177)
* Added notes about AI features

* Added link to LLM content, copy edited, and fixed linting errors

* Fixed references to dashgpt setup in create dashboards, added links and fixed linting issues

* Added links to panel option config docs and fixed linting issues

* Fixed link label

* Added dashgpt info to build first dashboard

* Apply suggestions from code review

Co-authored-by: Christopher Moyer <35463610+chri2547@users.noreply.github.com>

* Fixed links and heading level of new section

* Updated feature name

* Recast sentence

* Fixed formatting

* Added code formatting to feature flag

* Fixed link

---------

Co-authored-by: Christopher Moyer <35463610+chri2547@users.noreply.github.com>
Co-authored-by: Jack Baldry <jack.baldry@grafana.com>
2023-10-27 13:55:52 -04:00

6.1 KiB

aliases keywords labels 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
products
cloud
enterprise
oss
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

You can use generative AI to create panel titles and descriptions with the [Grafana LLM plugin][], which is currently in public preview. To enable this, refer to the [Set up generative AI features for dashboards documentation][]. Alternatively, you can take the following steps to create them yourself.

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. 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 can't repeat a panel zero times to hide it. {{% /admonition %}}

To see an example of repeating panels, refer to this 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 can't 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.

{{% docs/reference %}} [variables you have defined]: "/docs/grafana/ -> /docs/grafana//dashboards/variables" [variables you have defined]: "/docs/grafana-cloud/ -> /docs/grafana//dashboards/variables"

[global variables]: "/docs/grafana/ -> /docs/grafana//dashboards/variables/add-template-variables#global-variables" [global variables]: "/docs/grafana-cloud/ -> /docs/grafana//dashboards/variables/add-template-variables#global-variables"

[Configure repeating rows]: "/docs/grafana/ -> /docs/grafana//dashboards/build-dashboards/create-dashboard#configure-repeating-rows" [Configure repeating rows]: "/docs/grafana-cloud/ -> /docs/grafana//dashboards/build-dashboards/create-dashboard#configure-repeating-rows"

[Grafana LLM plugin]: "/docs/grafana/ -> /docs/grafana-cloud/alerting-and-irm/machine-learning/llm-plugin" [Grafana LLM plugin]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/alerting-and-irm/machine-learning/llm-plugin"

[Set up generative AI features for dashboards documentation]: "/docs/grafana/ -> /docs/grafana//dashboards/manage-dashboards#set-up-generative-ai-features-for-dashboards" [Set up generative AI features for dashboards documentation]: "/docs/grafana-cloud/ -> /docs/grafana-cloud/visualizations/dashboards/manage-dashboards#set-up-generative-ai-features-for-dashboards" {{% /docs/reference %}}