mirror of
https://github.com/grafana/grafana.git
synced 2025-02-11 16:15:42 -06:00
5d77d96d7b
* Update field-options.md * Update menu.yaml * Create _index.md * Update _index.md * added files * moving content * updated links * fixed links and deleted old file * content changes * Update configure-all-fields.md * Content updates * contnet updates * updated content * Update whats-new-in-v7-2.md * content updates * added content * Update filter-table-columns.md * Update standard-field-options.md * moved files * content edits * Update _index.md * Update _index.md * fixed links and merge conflicts * Update menu.yaml * Update menu.yaml
66 lines
3.4 KiB
Markdown
66 lines
3.4 KiB
Markdown
+++
|
|
title = "Add a panel"
|
|
type = "docs"
|
|
[menu.docs]
|
|
identifier = "add-a-panel"
|
|
parent = "panels"
|
|
weight = 100
|
|
draft = "true"
|
|
+++
|
|
|
|
# Add a panel
|
|
|
|
Panels allow you to show your data in visual form. This topic walks you through the most basic steps to build a panel.
|
|
|
|
## 1. Add a panel to a dashboard
|
|
|
|
1. Navigate to the dashboard you want to add a panel to.
|
|
1. Click the **Add panel** icon.
|
|
|
|
|
|
|
|
1. Click **Add new panel**.
|
|
|
|
Grafana creates an empty graph panel with your default data source selected.
|
|
|
|
## 2. Edit panel settings
|
|
|
|
While not required, we recommend that you add a helpful title and description to your panel. You can use [variables you have defined]({{< relref "../variables/templates-and-variables.md" >}}) in either field, but not [global variables]({{< relref "../variables/variable-types/global-variables.md" >}}).
|
|
|
|
|
|
|
|
**Panel title -** Text entered in this field is displayed at the top of your panel in the panel editor and in the dashboard.
|
|
|
|
**Description -** Text entered in this field is displayed in a tooltip in the upper left corner of the panel. Write a description of the panel and the data you are displaying. Pretend you are explaining it to a new user six months from now, when it is no longer fresh in your mind. Future editors (possibly yourself) will thank you.
|
|
|
|
## 3. Write a query
|
|
|
|
Each panel needs at least one query to display a visualization. You write queries in the Query tab of the panel editor. For more information about the Query tab, refer to [Queries]({{< relref "queries.md" >}}).
|
|
|
|
1. Choose a data source. In the first line of the Query tab, click the drop-down list to see all available data sources. This list includes all data sources you added. Refer to [Add a data source]({{< relref "../features/datasources/add-a-data-source.md" >}}) if you need instructions.
|
|
1. Write or construct a query in the query language of your data source. Options will vary. Refer to your specific [data source documentation]({{< relref "../features/datasources/_index.md" >}}) for specific guidelines.
|
|
|
|
## 4. Choose a visualization type
|
|
|
|
In the Visualization section of the Panel tab, click a visualization type. Grafana displays a preview of your query results with that visualization applied.
|
|
|
|
For more information about individual visualizations, refer to [Visualizations]({{< relref "visualizations/_index.md" >}}).
|
|
|
|
## 5. Apply changes and save
|
|
|
|
Save the dashboard. Either press Ctrl/Cmd+S or click **Save** in the upper right corner of the screen.
|
|
|
|
Your options vary depending on the changes you made and whether or not it is a new dashboard. We recommend you add a note to describe your changes before you click **Save**. Notes are very helpful if you need to revert the dashboard to a previous version.
|
|
|
|
## What next?
|
|
|
|
Our Grafana Fundamentals tutorial is a great place to start, or you can learn more about Grafana by reading one of the documentation topics linked below:
|
|
|
|
- Learn more about [panel editor]({{< relref "panel-editor.md" >}}) options.
|
|
- Add more [queries]({{< relref "queries.md" >}}).
|
|
- [Transform]({{< relref "transformations/_index.md" >}}) your data.
|
|
- [Configure]({{< relref "field-options/_index.md" >}}) how your results are displayed in the visualization.
|
|
|
|
- If you made a graph panel, set up an [alert]({{< relref "../alerting/alerts-overview.md" >}}).
|
|
- Create [templates and variables]({{< relref "../variables/templates-and-variables.md" >}}).
|