Scheduled Reports

This page is not yet available in Spanish. We are working on its translation.
If you have any questions or feedback about our current translation project, feel free to reach out to us!

Scheduled Reports are not supported for your selected Datadog site ().

Overview

Scheduled reports enable Datadog users to share dashboards as high-density PDFs on a recurring basis.

Example report PDF attachment

The report PDF can be sent to public Slack channels or email addresses.

Example report slack with PDF report linked

For emails, the report PDF is included as an email attachment or as a link, depending on its size.

Example report email with PDF attachment

Schedule a report

Create a report from any dashboard or timeboard that has at least one supported widget.

Click the Share button at the top of your dashboard and select Schedule report.

1. Set a schedule

In the configuration modal that opens, set a schedule for the report to determine when and how often the report is sent.

Section for defining a report schedule. Includes a schedule preview table showing the next 5 scheduled report dates.

2. Configure report

Define the report title and set a time frame to determine the range of time displayed in the resulting report. The report time frame can be different from the time frame displayed on the dashboard.

Note: Modifying the report time frame updates the Schedule Preview dropdown table above.

Section for defining a report schedule

Click Edit Variables to modify the filters applied when the report is sent. These values do not affect the dashboard’s default template variable values.

The configuration modal section for customizing the report title, timeframe and variables.

3. Add recipients

Email recipients

To add email recipients to your report, enter their email addresses. The email associated with your Datadog account is automatically added as a recipient. You can remove yourself as a recipient by hovering over your email and clicking the trash icon that appears next to it.

Note: Enterprise and Pro accounts can send reports to recipients outside of their organizations.

The configuration modal for editing scheduled report variables.

To see the report before saving the schedule, click Send Test Email. You can pause a report schedule at any time.

Slack recipients

To add Slack recipients, select the Slack workspace and channel from the available dropdowns. If you do not see any Slack workspaces available, ensure you have the Datadog Slack Integration installed. To send a test message to Slack, add a channel recipient and click Send Test Message.

The configuration modal for editing scheduled report email recipients.

Managing reports

A single dashboard can have multiple scheduled reports with different settings, which allows you to inform different groups of stakeholders interested in the same dashboard. To see the reports on an existing dashboard, click the Share button and select Configure Reports.

From the configuration modal that opens, you can pause an existing report or create a new report. To see and edit the details of an existing report, or delete the report, click Edit.

The configuration modal for scheduled reports, with two reports displayed, each showing their titles, tags, recipients, frequency, an option to toggle the report on or off, and a button to edit the report. At the bottom is a button to add a new report and a cancel button

Permissions

Users need the Dashboards Report Write permission to create and edit report schedules. This permission can be granted by another user with the User Access Manage permission.

A screenshot of an individual user's permissions from within the organization settings page. The dashboards report write permission is highlighted under the dashboards section

Users with the Org Management permission can enable or disable the scheduled reports feature for their organization from the Settings tab under Public Sharing in Organization Settings.

The Report Management setting in the Settings tab in Public Sharing within Organization Settings in Datadog with the setting Enabled

Additionally, users with the Org Management permission can enable or disable Slack recipients for their organization from the Settings tab under Public Sharing in Organization Settings.

The Send to Slack setting under Report Management setting in the Settings tab in Public Sharing within Organization Settings in Datadog with the setting Enabled

Unsupported widget types

The following widget types are not supported and will be shown as empty in the report:

Further Reading