Sharing Dashboards

Overview

Shared visualizations allow you to display metric, trace, and log visualizations outside of Datadog. You can share entire dashboards as well as individual graphs.

Dashboards

When you share a dashboard by URL or email link, the shared page shows live, read-only contents of that dashboard. When you generate a URL, you enable Sharing, and the dashboard becomes a public dashboard.

Share a dashboard by public URL

To share an entire dashboard publicly, generate a URL:

  1. On the dashboard’s page, click Share in the upper right.
  2. Select Generate public URL, which opens a Sharing: On pop-up modal.
  3. Under Time & Variable Settings, configure your desired options for the time frame and whether users can change it, as well as which tags are visible for selectable template variables. Note: At least one widget must be set to use Global Time.
  4. Copy the URL and click Done.

Note: Widgets based on APM traces queries do not display data on public dashboards. The Log Stream widget doesn’t show data either, but other log-based queries do.

Share a dashboard with individual email addresses

To authorize one or more specific email addresses to view a dashboard page:

  1. On the dashboard’s page, click Share in the upper right.
  2. Select Configure public URL, which opens a Sharing: On pop-up modal.
  3. Select Only specified people for indicating who can access this dashboard.
  4. Input the email addresses for people you would like to share your dashboard with.
  5. Under Time & Variable Settings, configure your desired options for the time frame and whether users can change it, as well as which tags are visible for selectable template variables. Note: At least one widget must be set to use Global Time.
  6. (Optional) Copy the URL to share; the specified email addresses also receive an email with the link.
  7. Click Done.

Note:

  • Individuals who are added to the allowlist for a dashboard receive a link in their email. If the link isn’t clicked on within one hour, they can request a new link on the dashboard landing page. If their email address is on the allowlist, a new email is sent.
  • Once clicked, a device is authorized to see the dashboard for up to 30 days. After that time is expired, the user can request a new link on the dashboard landing page. If their email address is on the allowlist, a new email is sent.
  • If a user is removed from the allowlist, access is removed.
  • Widgets based on APM traces queries do not display data on shared dashboards. The Log Stream widget doesn’t show data either, but other log-based queries do.

Revoke

To revoke access to a shared dashboard:

  1. Navigate to the Dashboard List.
  2. Select the dashboard you want to revoke access to.
  3. Click Share in the upper right.
  4. Click Configure public URL.
  5. Click Revoke URL.

Refresh interval

Publicly shared dashboards refresh every 30 seconds. This refresh interval cannot be customized.

Graphs

Share

To share a graph from a Timeboard or Screenboard:

  1. For the graph you want to share, click the pencil icon in the upper right corner.
  2. Under the Graph your data section, select the Share tab.
  3. Pick a timeframe for your graph.
  4. Pick a graph size.
  5. Choose to include the legend or not.
  6. Get the embed code with the Generate embed code button.
Share tab in a graphing editor

Revoke

To revoke the keys used to share individual (embedded) graphs:

  1. Navigate to Organization Settings -> Public Sharing -> Shared Graphs to see a list of all shared graphs.
  2. Click on the Revoke button next to the graph you want to stop sharing.
  3. The graph is moved to the Revoked list.

Applying restrictions

You can restrict access on an IP address basis to your dashboard. Email Datadog support to enable the IP address include listing feature that allows administrators to provide a list of IP addresses that have access to shared dashboards. After it’s enabled, manage your restrictions on your organization’s Public Sharing page.

Dark mode

Dark mode is available on public dashboards for individual users. Click the sun or moon icon in the upper right to toggle between modes. Additionally, the URL parameter theme is available. The possible values are dark and light.

TV mode

TV mode is available on public dashboards. Use the keyboard shortcut F or click Configure in the upper right and select TV mode.

API

Datadog has a dedicated API allowing you to interact with your shared graphs (embeds):

EndpointDescription
Get all embedsGet a list of previously created embeddable graphs.
Create embedCreates a new embeddable graph.
Get specific embedGet the HTML fragment for a previously generated embed with embed_id.
Enable embedEnable the specified embed.
Revoke embedRevoke the specified embed.

Further Reading

Additional helpful documentation, links, and articles:

Share dashboards securely with anyone outside of your organizationBLOG more more Create Dashboards in DatadogDOCUMENTATION more more Enhance your Dashboards with Template VariablesDOCUMENTATION more more Discover Widgets for your DashboardDOCUMENTATION more more