mirror of
https://github.com/grafana/grafana.git
synced 2025-09-26 23:14:36 +08:00
852d069a3c
* Docs: Revise data source index * Docs: Consolidate data source administration docs * Docs: Revise panels docs related to data sources * Docs: Revise Alertmanager data source * Docs: Reorganize AWS CloudWatch data source docs * Docs: Reorganize Azure Monitor data source docs * Docs: Move azuremonitor to azure-monitor * Docs: Revise Elasticsearch docs * Docs: Move Elasticsearch index into bundle * Docs: Revise GCM docs * Docs: Revise Graphite docs * Docs: Move Graphite index into bundle * Docs: Revise InfluxDB docs * Docs: Revise Jaeger docs * Docs: Move Jaeger index into bundle * Docs: Revise Loki docs * Docs: Move Loki index into bundle * Docs: Revise MS SQL docs * Docs: Move MS SQL index into bundle * Docs: Revise Prometheus docs * Docs: Move Prometheus index into bundle * Docs: Revise Tempo docs * Docs: Move Tempo index into bundle * Docs: Revise TestData DB docs * Docs: Move TestData DB index into bundle * Docs: Revise Zipkin docs * Docs: Move Zipkin index into bundle * Docs: Move other data sources' index pages into bundles * Docs: Revise frontmatter * Fixing hugo markdown errors * Docs: Add query editor and template var sections to overview doc * Docs: Remove CTAs across data source docs * Docs: Remove CTA * Docs: Remove CTA * Docs: Fix links, images, typos, and usage consistency. * Docs: Fix typos * Docs: Fix CI issues * Update docs/sources/datasources/_index.md Co-authored-by: Torkel Ödegaard <torkel@grafana.com> * Update docs/sources/datasources/_index.md Co-authored-by: Torkel Ödegaard <torkel@grafana.com> * Docs: Fix query editor links * Update docs/sources/panels-visualizations/_index.md Co-authored-by: Torkel Ödegaard <torkel@grafana.com> * Update docs/sources/panels-visualizations/_index.md Co-authored-by: Torkel Ödegaard <torkel@grafana.com> * Docs: Rebundle child pages per writers' toolkit * Docs: Fix prettier for CI * Docs: Fix relrefs from outside data sources docs * Docs: Fix broken relrefs within datasources * Docs: Fix relrefs to data sources docs * Fixed some more refs Co-authored-by: Torkel Ödegaard <torkel@grafana.com>
93 lines
4.1 KiB
Markdown
93 lines
4.1 KiB
Markdown
---
|
|
aliases:
|
|
- /docs/grafana/latest/dashboards/build-dashboards/create-dashboard/
|
|
- /docs/grafana/latest/dashboards/build-dashboards/add-organize-panels/
|
|
title: Create a dashboard
|
|
menuTitle: Create a dashboard
|
|
weight: 1
|
|
keywords:
|
|
- panel
|
|
- dashboard
|
|
- create
|
|
---
|
|
|
|
## Create a dashboard
|
|
|
|
Dashboards and 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 permissions. For more information about permissions, refer to [About users and permissions]({{< relref "../../../administration/roles-and-permissions/" >}}).
|
|
- 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 "../../../administration/data-source-management#add-a-data-source" >}}) if you need instructions.
|
|
|
|
**To create a dashboard**:
|
|
|
|
1. Sign in to Grafana, hover your cursor over **Dashboard**, and click **+ New Dashboard**.
|
|
1. Click **Add a new panel**.
|
|
1. In the first line of the **Query** tab, click the drop-down list and select a data source.
|
|
1. 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/" >}}) for specific guidelines.
|
|
|
|
1. 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 "../../../panels-visualizations/visualizations/" >}}).
|
|
|
|
1. Refer to the following documentation for ways you can adjust panel settings.
|
|
|
|
While not required, most visualizations need some adjustment before they properly display the information that you need.
|
|
|
|
- [Configure value mappings]({{< relref "../../../panels-visualizations/configure-value-mappings" >}})
|
|
- [Visualization-specific options]({{< relref "../../../panels-visualizations/visualizations/" >}})
|
|
- [Override field values]({{< relref "../../../panels-visualizations/configure-overrides/" >}})
|
|
- [Configure thresholds]({{< relref "../../../panels-visualizations/configure-thresholds/" >}})
|
|
- [Configure standard options]({{< relref "../../../panels-visualizations/configure-standard-options/" >}})
|
|
|
|
1. 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.
|
|
|
|
## Configure repeating rows
|
|
|
|
You can configure Grafana to dynamically add panels or rows to a dashboard based on the value of a variable. Variables dynamically change your queries across all rows in a dashboard. For more information about repeating panels, refer to [Configure repeating panels](../../panels/configure-panel-options/#configure-repeating-panels).
|
|
|
|
To see an example of repeating rows, refer to [Dashboard with repeating rows](https://play.grafana.org/d/000000153/repeat-rows). The example shows that you can also repeat rows if you have variables set with `Multi-value` or `Include all values` selected.
|
|
|
|
**Before you begin:**
|
|
|
|
- Ensure that the query includes a multi-value variable.
|
|
|
|
**To configure repeating rows:**
|
|
|
|
1. On the dashboard home page, click **Add panel**.
|
|
|
|
1. On the **Add a panel** dialog box, click **Add a new row**.
|
|
|
|
1. Hover over the row title and click the cog icon.
|
|
|
|
1. On the **Row Options** dialog box, add a title and select the variable for which you want to add repeating rows.
|
|
|
|
> **Note:** To provide context to dashboard users, add the variable to the row title.
|
|
|
|
## Move a panel
|
|
|
|
You can place a panel on a dashboard in any location.
|
|
|
|
1. Open the dashboard.
|
|
|
|
1. Click the panel title and drag the panel to the new location.
|
|
|
|
## Resize a panel
|
|
|
|
You can size a dashboard panel to suits your needs.
|
|
|
|
1. Open the dashboard.
|
|
|
|
1. To adjust the size of the panel, click and drag the lower-right corner of the panel.
|