Datadog dashboards enable you to efficiently monitor your infrastructure and integrations by displaying and tracking key metrics.
Integration Preset Dashboards¶
If you would like to create a default dashboard for an integration, follow the guidelines in the Best Practices section.
Exporting a dashboard payload¶
When you've created a dashboard in the Datadog UI, you can export the dashboard payload to be included in its integration's assets directory.
Ensure that you have set an
APP_KEY for the org that contains the new dashboard in the ddev configuration.
Run the following command to export the dashboard:
ddev meta dash export <URL_OF_DASHBOARD> <INTEGRATION>
If the dashboard is for a contributor-maintained integration in the
integration-extras repo, run the command with the
The command will add the dashboard definition to the
manifest.json file of the integration. The dashboard JSON payload will be available in
Commit the changes and create a pull request.
Verify the Preset Dashboard¶
Once your PR is merged and synced on production, you can find your dashboard in the Dashboard List page.
Make sure the integration tile is
Installed in order to see the preset dashboard in the list.
Ensure logos render correctly on the Dashboard List page and within the preset dashboard.
When creating a new dashboard, select the Screenboard type.
Integration preset (or out of the box) dashboards are typically screenboards because they allow images, widgets, and labels. Learn more about Datadog dashboards and see the differences between screenboards and timeboards.
Dashboard titles should contain the integration name. Some examples of a good dashboard title are
Note: Avoid using
-in the dashboard title as the dashboard URL is generated from the title.
Research the metrics supported by the integration and consider grouping them in relevant categories. Important metrics that are key to the performance and overview of the integration should be at the top.
Ensure good design by keeping labels and widgets aligned with consistent spacing and reasonable size.
TV Mode to ensure that the whole dashboard fits your screen. As more content is added, the recommended view of preset dashboards is vertical.
Integration logos should be placed at the top-left of the dashboard and centered on the image widget.
The suggested height for logos is around 12 grid units.
Labels are created from the Notes & Links widget type.
Labels are used to divide the screenboard in visually comprehensive sections.
- Category labels have
vivid bluebackgrounds to contrast with the board and widgets.
Text size is heading level 1
#and horizontally centered.
Do not use bold or all capitalized letters because it can make the dashboard harder to read. See the labels
Page Summaryin the Ignite dashboard example.
Horizontal labels should be kept above the graphs and their width should be the length of the entire section.
If there is a corresponding Datadog blog post, category names should be linked to the relevant section of the article.
With large sections of metric widgets, use subcategory labels to provide additional context. An example subcategory is grouping reads and writes metrics.
- Subcategory labels have blue backgrounds.
- Text size is heading level 1 and horizontally centered.
- A brief description of the subcategory should have the font size 18px. See labels
Cachein the Ignite dashboard example above.
- Subcategory labels have the same rules as metric category labels.
Labels can also be used as memos to describe a section or metric.
The most top-left note should have the background color white and provide an overview of the integration and dashboard with links to relevant blog posts and documentation.
- Other notes for metric sections should have the background color of gray.
- Text must be 14px, left alignment, and not bold.
- Notes should have pointers enabled and directing which section the information is referring to.
- Notes should provide explanations for certain behaviors that may be observed from the widgets.
Some integrations are closely related to other technologies. Screenboards that contain metrics from other integration should use a different style to differentiate the products.
- Labels for the external technologies have pink backgrounds.
- Text must be 18px (consistent with other metric category labels), horizontally centered, and not bold.
- These labels have the same rules as metric category labels.
The suggested separation between widgets is:
- 2 grid units between different categories
- 1 grid unit between graphs of the same category
Widgets of the same type must be the same size and consistently aligned across the dashboard.
Graph titles summarize the queried metric.
- Titles are aligned to the left.
- Do not include timeframes (e.g "Average latency of the past day") because it's already indicated on the graph itself.
- Do not indicate the unit in the graph title because unit types are displayed automatically from metadata. An exception to this is if the calculation of the query represents a different type of unit.
For more information on the available widget types, see the list of supported dashboard widgets.
Metric widgets usually have a timeframe of 4 hours. Query value widgets have the timeframe of 1 hour.
Timeseries widgets allow you to visualize the evolution of one or more metrics over time.
|Types of metrics||Palette|
|Errors/negative (e.g. Queued requests)||Warm or orange color|
|Memory||Cool or blue color|
|Types of metrics||Display Type|
|Volume (e.g. Number of connections)|| |
|Counts (e.g. Number of errors)|| |
|Multiple groups or default|| |
Add an event stream only if the service monitored by the dashboard is reporting events. Use
Event stream widgets typically have a timeframe of 1 week.
Template variables allow you to dynamically filter one or more widgets in a dashboard.
- Template variables must be universal and accessible by any user or account using the monitored service.
- Make sure all relevant graphs are listening to the relevant template variable filters.
*=scope as a tempoate variable is useful since users can access all their own tags.