opensource/grafana
1
0
Fork 0
mirror of https://github.com/grafana/grafana.git synced 2025-07-30 20:42:31 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
grafana/docs/sources/panels/working-with-panels/add-panel.md
Christopher Moyer 449c608ef1 Docs/panel refactor (#43569) 
* new refactored panel docs

* fixed links

* removed xtra sharing link, added links to panel display option tasks

* fixed typo

* add aliases

* incorporate PM feedback

* intermediate commit to resolve merge conflict

* final changes to resolve merge conflicts
2022-01-18 15:06:27 -06:00

2.7 KiB
Raw Blame History

+++ title = "Add a panel to a dashboard" aliases = ["/docs/sources/panels/working-with-panels/add-panel/"] weight = 20 +++

Add a panel to a dashboard

Panels allow you to show your data in visual form. Each panel needs at least one query to display a visualization.

Before you begin

  • Ensure that you have the proper [organization role]({{< relref "../../permissions/organization_roles.md" >}}) or [permissions]({{< relref "../../permissions/_index.md" >}}).
  • Identify the dashboard to which you want to add the panel.
  • Understand the query language of the target data source.
  • Ensure that data source for which you are writing a query has been added. For more information about adding a data source, refer to [Add a data source]({{< relref "../../datasources/add-a-data-source.md" >}}) if you need instructions.

To add a panel to a dashboard:

  1. Navigate to the dashboard to which you want to add a panel.

  2. Click the Add panel icon.

  3. Click Add an empty panel.

    Grafana creates an empty time-series panel and selects the default data source.

  4. In the first line of the Query tab, click the drop-down list and select a data source.

  5. Write or construct a query in the query language of your data source.

    For more information about data sources, refer to [Data sources]({{< relref "../../datasources/_index.md" >}}) for specific guidelines.

  6. In the Visualization list, select a visualization type.

    Grafana displays a preview of your query results with the visualization applied.

    For more information about individual visualizations, refer to [Visualizations options]({{< relref "../../visualizations/_index.md" >}}).

  7. Refer to the following documentation for ways you adjust panel settings.

    While not required, most visualizations need some adjustment before they properly display the information that you need.

    • [Format data using value mapping]({{< relref "../format-data/about-value-mapping.md" >}})
    • [Visualization-specific options]({{< relref "../../visualizations/_index.md" >}})
    • [Override field values]({{< relref "../override-field-values/about-field-overrides.md" >}})
    • [Specify thresholds to set the color of visualization text and background]({{< relref "../specify-thresholds/about-thresholds.md" >}})
    • [Apply color to series and fields]({{< relref "./apply-color-to-series.md" >}})

  8. Add a note to describe the visualization (or describe your changes) and then click Save in the upper-right corner of the page.

    Notes can be helpful if you need to revert the dashboard to a previous version.