Skip to content

Dashboards


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 API_KEY and 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>

Tip

If the dashboard is for a contributor-maintained integration in the integration-extras repo, run the command with the --extras or -e flag.

The command will add the dashboard definition to the manifest.json file of the integration. The dashboard JSON payload will be available in /assets/dashboards/<DASHBOARD_TITLE>.json.

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.

Tip

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.

Best Practices

Ignite dashboard

  1. When creating a new dashboard, select the Screenboard type.

    Information

    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.

  2. Dashboard titles should contain the integration name. Some examples of a good dashboard title are Syclla and Cilium Overview.

    Note: Avoid using - in the dashboard title as the dashboard URL is generated from the title.

  3. 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.

  4. Ensure good design by keeping labels and widgets aligned with consistent spacing and reasonable size.

Tip

Use TV Mode to ensure that the whole dashboard fits your screen. As more content is added, the recommended view of preset dashboards is vertical.

Logos

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

Labels are created from the Notes & Links widget type.

Metric Categories

Labels are used to divide the screenboard in visually comprehensive sections.

  • Category labels have vivid blue backgrounds to contrast with the board and widgets.
  • Text size is heading level 1 # and horizontally centered.

    Important

    Do not use bold or all capitalized letters because it can make the dashboard harder to read. See the labels Job Summary and Page Summary in 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.

Subcategories

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 Memory or Cache in the Ignite dashboard example above.
  • Subcategory labels have the same rules as metric category labels.

Notes

Labels can also be used as memos to describe a section or metric.

Important

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.

Other technologies

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.

Widgets

The suggested separation between widgets is:

  • 2 grid units between different categories
  • 1 grid unit between graphs of the same category

Important

Widgets of the same type must be the same size and consistently aligned across the dashboard.

Graph titles

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.

Metrics

There are different types of metric widgets. The most commonly used are timeseries, query values, and tables.

For more information on the available widget types, see the list of supported dashboard widgets.

Note

Metric widgets usually have a timeframe of 4 hours. Query value widgets have the timeframe of 1 hour.

Timeseries

Timeseries widgets allow you to visualize the evolution of one or more metrics over time.

Color Palette
Types of metrics Palette
Errors/negative (e.g. Queued requests) Warm or orange color
Memory Cool or blue color
Read Green color
Write Purple color
Display type
Types of metrics Display Type
Volume (e.g. Number of connections) area
Counts (e.g. Number of errors) bars
Multiple groups or default lines

Event stream

Add an event stream only if the service monitored by the dashboard is reporting events. Use sources:service_name.

Note

Event stream widgets typically have a timeframe of 1 week.

Template Variables

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.

Tip

Adding *=scope as a tempoate variable is useful since users can access all their own tags.


Last update: March 3, 2021