The Service Map for APM is here!

Shared Graphs


Shared Graphs and Screenboards allow you to display metric, trace, and log visualizations outside of Datadog while being able to apply access restriction to your Embeds.

Sharing a particular Graph

To share a Graph from a Timeboard or a Screenboard:

  1. Choose a graph.
  2. Click the pencil icon in the upper right corner to edit it.
  3. Under step 2: Graph your data select the share tab:
  4. Pick a fixed timeframe for your graph.
  5. Pick a graph size.
  6. Choose to include the legend or not.
  7. Get the embed code with the Generate embed code button.
Shared graph

Sharing a Screenboard

Share a Screenboard entirely with the following process:

  1. Click the settings cog in the upper right of the screen.
  2. Click the Generate public URL option.
  3. Use the created URL to have live and read-only access to just the contents of that Screenboard.

Note: If you’ve enabled Templating, the template variable drop down isn’t present in the shared views.

Applying restrictions

You can restrict access on a per-IP address basis to your Embed. Email the Datadog support team to enable the IP address white listing feature that allows administrators to provide a list of IP addresses that have access to shared dashboards.

These shared graphs can be embedded in external-facing tools using the provided iframe as well as shared directly using the source URL provided in the text box. This can be used externally without additional authorization required for access. Once enabled, manage your restrictions on your organisation security page.

Note: If you have enabled Dashboard Template Variables, the template variable drop-downs will not be present in the shared views. We advise to avoid using these if you intend on sharing the views outside of your organization.

Revoking shared graphs/Screenboard

Revoking an embedded graphs

To revoke the keys used to share your graphs:

  1. Navigate to Integrations -> Embeds to find a list of all the graphs that are shared.
  2. Click on the Revoke button for the graph you want to stop sharing.
  3. The graph moves then to the Revoked list.
Embedded graph

Revoking a Screenboard

To revoke a shared Screenboard:

  1. Navigate to the Dashboard List.
  2. Select the Screenboard you want to revoke access to.
  3. Click on the cog to edit it.
  4. Click Revoke public URL.


Datadog has a dedicated API allowing you to interact with your Embeds:

Endpoint Description
Get all embeds Gets 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 a specified embed.
Revoke embed Revoke a specified embed.

Further Reading