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:
- On the dashboard’s page, click the export icon in the upper right.
- Select Generate public URL, which opens up 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 the export icon in the upper right.
- Select Generate public URL, which opens up 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. 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:
- Navigate to the Dashboard List.
- Select the dashboard you want to revoke access to.
- Click on the export icon 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 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 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 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):
Further Reading
Additional helpful documentation, links, and articles:
