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:
- On the dashboard’s page, click Share in the upper right.
- Select Generate public URL, which opens a Sharing: On pop-up modal.
- 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.
- 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:
- On the dashboard’s page, click Share in the upper right.
- Select Configure public URL, which opens a Sharing: On pop-up modal.
- Select Only specified people for indicating who can access this dashboard.
- Input the email addresses for people you would like to share your dashboard with.
- 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.
- (Optional) Copy the URL to share; the specified email addresses also receive an email with the link.
- 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:
- Navigate to the Dashboard List.
- Select the dashboard you want to revoke access to.
- Click Share in the upper right.
- Click Configure public URL.
- 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:
- For the graph you want to share, click the pencil icon in the upper right corner.
- Under the Graph your data section, select the Share tab.
- Pick a timeframe for your graph.
- Pick a graph size.
- Choose to include the legend or not.
- Get the embed code with the Generate embed code button.
Revoke
To revoke the keys used to share individual (embedded) graphs:
- Navigate to Organization Settings -> Public Sharing -> Shared Graphs to see a list of all shared graphs.
- Click on the Revoke button next to the graph you want to stop sharing.
- 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):
Further Reading
Additional helpful documentation, links, and articles: