• EnglishEspañol日本語한국어Português
  • Log inStart now

NerdGraph tutorial: Export dashboards as files

Do you need to schedule reports that contain charts or dashboards? Do you want to automate how you share dashboards? You can obtain your as PDF or PNG files programmatically with a GraphQL mutation. You can also export dashboards as PDF files using the UI.

For example, you can generate static, snapshot versions of your New Relic dashboards and send them to Slack or download as files.

Export dashboard pages

  1. Obtain the dashboard's GUID: Click the icon by the dashboard's name to access the metadata widget and see the dashboard's GUID.

  2. Get the individual pages' GUIDs using the query below:

    actor {
    query: "id ='YOUR_PAGE_GUID' OR parentId ='YOUR_PAGE_GUID' AND tags.isDashboardPage = 'true'"
    ) {
    results {
    entities {
    ... on DashboardEntityOutline {
  3. Run the dashboardCreateSnapshotURL mutation in the NerdGraphQL explorer as many times as dashboard pages you want to export. You just need to provide the desired dashboard page GUID as a parameter.

  4. Get the link to retrieve your dashboard page as a PDF. The link looks similar to:

  5. Configure the exported file, if necessary.

Configure the file you retrieve

Edit the returned link to change the format of your export (PDF or PNG), or resize it.

For example, if you obtain the link:


You could:

  • Substitute PDF for PNG to get an image.
  • Modify the width and height fields to adjust the size to your needs. The maximum value is 2000.


Here's what to do if you experience any of the following errors while trying to export a dashboard:

These errors can be caused if the generation of the PDF exceeds the API max response time. If you encounter these errors, check if any of the widgets on your dashboard have a large time window. For example, you might compare data from an entire month versus previous months. If you see a large time window, try decreasing the window.

Another possible cause of these errors is that your dashboard may have a large number of widgets. If you have widgets you don't use, you might try removing some to see if this resolves the error.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.