Create a dasard
Dasards 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.
- Identify the dasard 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 if you need instructions.
To create a dasard:
Click Dasards in the main menu.
Click New and select New Dasard.
On the empty dasard, click + Add visualization.
In the dialog box that opens, do one of the following:
- Select one of your existing data sources.
- Select one of the Grafana built-in special data sources.
- Click Configure a new data source to set up a new one (Admins only).
The Edit panel view opens with your data source selected. You can change the panel data source later using the drop-down in the Query tab of the panel editor if needed.
For more information about data sources, refer to Data sources for specific guidelines.
Write or construct a query in the query language of your data source.
Click Refresh to query the data source.
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.
Under Panel options, enter a title and description for your panel or have Grafana create them using generative AI features.
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.
When you’ve finished editing your panel, click Save dasard.
Alternatively, click Back to dasard if you want to see your changes applied to the dasard first. Then click Save dasard when you’re ready.
Enter a title and description for your dasard or have Grafana create them using generative AI features.
Select a folder, if applicable.
Click Save.
To add more panels to the dasard, click Back to dasard. Then click Add in the dasard header and select Visualization in the drop-down.
When you add additional panels to the dasard, you’re taken straight to the Edit panel view.
When you’ve saved all the changes you want to make to the dasard, click Exit edit.
Now, when you want to make more changes to the saved dasard, click Edit in the top-right corner.
Copy a dasard
To copy a dasard, follow these steps:
Click Dasards in the main menu.
Open the dasard you want to copy.
Click Edit in top-right corner.
Click the Save dasard drop-down and select Save as copy.
(Optional) Specify the name, folder, description, and whether or not to copy the original dasard tags for the copied dasard.
By default, the copied dasard has the same name as the original dasard with the word “Copy” appended and is in the same folder.
Click Save.
Configure repeating rows
You can configure Grafana to dynamically add panels or rows to a dasard based on the value of a variable. Variables dynamically change your queries across all rows in a dasard. For more information about repeating panels, refer to Configure repeating panels.
To see an example of repeating rows, refer to Dasard with repeating 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:
Click Dasards in the main menu.
Navigate to the dasard you want to work on.
At the top of the dasard, click Add and select Row in the drop-down.
If the dasard is empty, you can click the + Add row button in the middle of the dasard.
Hover over the row title and click the cog icon.
In the Row Options dialog box, add a title and select the variable for which you want to add repeating rows.
Click Update.
To provide context to dasard users, add the variable to the row title.
Repeating rows and the Dasard special data source
If a row includes panels using the special Dasard data source—the data source that uses a result set from another panel in the same dasard—then corresponding panels in repeated rows will reference the panel in the original row, not the ones in the repeated rows.
For example, in a dasard:
Row 1
includesPanel 1A
andPanel 1B
Panel 1B
uses the results fromPanel 1A
by way of the-- Dasard --
data source- Repeating row,
Row 2
, includesPanel 2A
andPanel 2B
Panel 2B
referencesPanel 1A
, notPanel 2A
Move a panel
You can place a panel on a dasard in any location.
- Click Dasards in the main menu.
- Navigate to the dasard you want to work on.
- Click Edit in the top-right corner.
- Click the panel title and drag the panel to the new location.
- Click Save dasard.
- (Optional) Enter a description of the changes you’ve made.
- Click Save.
- Click Exit edit.
Resize a panel
You can size a dasard panel to suits your needs.
- Click Dasards in the main menu.
- Navigate to the dasard you want to work on.
- Click Edit in the top-right corner.
- To adjust the size of the panel, click and drag the lower-right corner of the panel.
- Click Save dasard.
- (Optional) Enter a description of the changes you’ve made.
- Click Save.
- Click Exit edit.