Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.
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
Navigate to the dashboard you want to add a panel to.
Click the Add panel icon.
Click Add an empty panel.
Grafana creates an empty time series panel with your default data source selected.
2. 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.
- 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 if you need instructions.
- Write or construct a query in the query language of your data source. Options will vary. Refer to your specific data source documentation for specific guidelines.
3. Choose a visualization
When you choose a visualization, Grafana will offer visualization suggestions based on your query. You can select from the available suggestions or you can pick a visualization from the complete list of supported visualizations. When you select a visualization, Grafana will show a preview of your query results with that visualization applied. For more information about individual visualizations, refer to Visualizations options.
4. (Optional) Edit panel settings
While not required, most visualizations need some adjustment before they properly display the information that you need. Options are defined in the linked topics below.
- Panel options
- Visualization-specific options
- Standard options
- Thresholds
- Value mappings
- Data links
- Field overrides
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 options.
- Add more queries.
- Transform your data.
- Set up an alert.
- Create templates and variables.