Visualize dashboard contents with panels
Chart panels, also called panels, transform or filter the results of a query and visualize them.
For details about panels, see the Grafana documentation (opens in a new tab).
To add a panel to a dashboard:
- Open the dashboard.
- Click the Add Panel icon, styled as a bar chart with a plus sign (+) icon.
- In the placeholder panel that appears, click Add new panel.
After adding your desired panels, click the Save dashboard button to save your changes.
You can customize the features of each panel in your dashboards in its panel editor.
To access the panel editor:
- Click the panel's title to open its controls.
- Click Edit to open the panel editor.
Grafana provides many options and controls in the panel editor that aren't documented in this guide. For details, see the Grafana documentation (opens in a new tab).
A panel's type defines its visualization method. By default, a new panel is of the Graph type. For a list of core panel types, see the Grafana documentation (opens in a new tab).
To change the panel's type:
- Open the panel's editor.
- Click Show options.
- Select a type under the Visualizations section.
- Optional: Click Apply to save any panel type changes and exit the panel editor.
A panel's data source defines what the panel queries for the data that it visualizes. By default, a new panel queries the Chronosphere Prometheus data source. If you're ingesting metrics from Graphite, change the data source to Chronosphere Graphite.
To change the panel's data source:
- Open the panel's editor.
- In the Query tab, click the data source dropdown.
- Select a data source.
- Optional: Click Apply to save any data source changes and exit the panel editor.
To populate the panel with data from the selected data source, you write queries in the panel editor's query editor. The query editor interface can change based on the panel's data source.
To change the query for the default Chronosphere Prometheus data source:
Open the panel's editor.
In the Query tab, enter PromQL expressions in the Query field.
The visualization preview changes as you edit the query. If the query results in an error, a ! tab appears in the visualization preview's title bar that provides the error message when you hold the pointer over it.
Optional: Customize the query's presentation by editing the fields beneath the query.
Optional: Add additional queries by clicking the + Query button.
Optional: Click Apply to save any query changes and exit the panel editor.
For details about writing queries, read the querying documentation.
Chronosphere also includes an interactive Query Builder that you can use to construct, optimize, and debug queries before saving, using, and sharing them with your team.
For details, see the Query Builder documentation.
The dashboard edit screen might suggest using a
rate() function when querying
metrics. However, Chronosphere recommends using
rate() only with Counter panels.
Although this message is relevant only with Counter panels, it sometimes appears
when editing Gauge panels. Grafana suggests using
rate() based on the metric
name and keywords, such as
total, even when it's inappropriate for
a panel type.
Also, be aware that the Grafana special variable
$__rate_interval has unique
behavior that might not be compatible with the Chronosphere Prometheus data source's
scrape interval. Chronosphere recommends using a separate
$interval variable instead.
To save changes to a panel and exit the panel editor, click Apply.
To save changes to both the panel and dashboard, and then exit the panel editor, click Save.
To exit the panel editor without saving changes, click Discard.
To save changes to a dashboard's panels and layout from the dashboard view:
- Click Save dashboard, represented by a disk icon.
- Optional: If you changed the dashboard's time range and want to save it as the default range, select Save current time range as dashboard default.
- Optional: In the Save dashboard dialog, describe the change.
- Click Save.