The pie chart widget can display a single dataset with corresponding proportions, or multiple datasets with nested proportions.
Configuration
- Select from the available data sources.
- Configure the query, see the following resources for more information:
- Metrics: See the querying documentation to configure a metric query.
- Events: See the log search documentation to configure a log event query.
- (Optional) Modify query with a formula.
- Customize your graph.
Graph customization
Total amount display
Toggle whether to show a total count in the center of the chart. By default, the Automatic option shows the total count once the graph reaches a certain size.
Legend configuration
The legend can be turned off, displayed directly over chart segments with the Aside option, or as a Table listing each value, its color, and proportion.
By default, the Automatic option shows a labeled Aside legend within a dashboard, and displays both the Aside and Table legends when opened in full-screen.
Context links
Context links are enabled by default, and can be toggled on or off. Context links bridge dashboard widgets with other pages (in Datadog, or third-party).
Display and interaction
Filter and focus
In the case where multiple groups of data are plotted at once, you can choose a single category and view proportions within it.
To view a single category, hover over the outer portion of the category ring, and click. To go back to the previous view, move your cursor to the center of the chart and click.
Full-screen
Viewing the pie chart widget in full-screen reveals the standard set of full-screen options.
API
This widget can be used with the Dashboards API.
Like the pie chart widget, the treemap can also be used to display nested proportions. The primary difference between the two is that the pie chart displays proportions in radial slices, and the treemap displays nested rectangles.
Further Reading
Additional helpful documentation, links, and articles:
