Sharing
Security Monitoring is now available Security Monitoring is now available

Sharing

Overview

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

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.

Dashboards

Share

Share an entire dashboard by generating a public URL:

  1. On the dashboard’s page, click the settings cog in the upper right.
  2. Choose the Generate public URL option.
  3. Choose configuration options for “Allow changing timeframe” and/or template variables visible tags.
  4. Copy the URL and click Done.

The created URL has live, read-only access to the contents of that specific dashboard.

Note: Dashboard template variable selectors are only present on dashboards when you configure visible tags. The template variables’ default values are the default values set in Datadog. Additionally, widgets based on APM traces queries do not display data on public dashboards. All log based queries will show data, except the Log Stream widget.

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.

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):

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