Sharing Dashboards

Sharing Dashboards

Overview

Shared dashboards and graphs allow you to display metric, trace, and log visualizations outside of Datadog.

Dashboards

When you share a dashboard by URL or email link, the shared page shows live, read-only contents of that dashboard.

Share a dashboard by public URL

To share an entire dashboard publicly, generate a URL:

  1. On the dashboard’s page, click the settings cog in the upper right.
  2. Select Generate public URL.
  3. Under Time & Variable Settings, configure your desired options for the time frame and whether users can change it, as well which tags are visible for selectable template variables.
  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 the settings cog in the upper right.
  2. Select Generate public URL.
  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 which tags are visible for selectable template variables.
  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. Once 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 a shared dashboard:

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

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.

Revoke

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

  1. Navigate to Integrations -> Embeds 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 a per 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. Once enabled, manage your restrictions on your organization’s Security 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 screenboards. Use the keyboard shortcut F or click the TV icon in the upper right.

API

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

Endpoint Description
Get all embeds Get a list of previously created embeddable graphs.
Create embed Creates a new embeddable graph.
Get specific embed Get the HTML fragment for a previously generated embed with embed_id.
Enable embed Enable the specified embed.
Revoke embed Revoke the specified embed.

Further Reading