NerdGraphチュートリアルダッシュボードをファイルとしてエクスポートする

チャートやダッシュボードを含むレポートをスケジュールする必要がありますか？ダッシュボードの共有方法を自動化したいと思いませんか？ GraphQL のミューテーションを使用して、ダッシュボードをPDFまたはPNGファイルとしてプログラムで取得できます。また、 UIを使用してダッシュボードをPDFファイルとしてエクスポートすることもできます。。

例えば、New Relicのダッシュボードの静的なスナップショット版を生成し、Slackに送信したり、ファイルとしてダウンロードしたりすることができます。その方法については、こちらの短いYouTube動画（約4分）をご覧ください。

ダッシュボードページのエクスポート

ダッシュボードの GUID を取得する：ダッシュボード名の横にあるアイコンをクリックし、 See metadata and manage tags モーダルにアクセスし、ダッシュボードの GUID を確認することができます。
以下のクエリを使用して、個々のページのGUIDを取得します。
```
{
 actor {
    entitySearch(query: "id ='YOUR_PAGE_GUID' OR parentId ='YOUR_PAGE_GUID' AND tags.isDashboardPage = 'true'" ) {
      results {
        entities {
          guid
          name
          ... on DashboardEntityOutline {
            guid
            name
            dashboardParentGuid
          }
        }
      }
    }
  }
}
```
dashboardCreateSnapshotURL 変異を NerdGraphQL エクスプローラーで、エクスポートしたいダッシュボード・ページの数だけ実行します。必要なダッシュボードページのGUIDをパラメータとして指定する必要があります。
ダッシュボードページをPDFで取得するためのリンクを取得します。リンクは以下のようになっています。

https://gorgon.nr-assets.net/image/e0c22263-2d88-40bc-940a-b885dbc1d98d?format=PDF&width=2000&height=2000

必要に応じて、エクスポートしたファイルの設定を行います。

取得したファイルの設定

戻ってきたリンクを編集して、エクスポートのフォーマット（PDFまたはPNG）を変更したり、サイズを変更したりします。

例えば、お客様がリンクを取得した場合。

https://gorgon.nr-assets.net/image/e0c22263-2d88-40bc-940a-b885dbc1d98d?format=PDF&width=2000&height=2000

できました。

画像を取得するには、 PNGをPDFに置き換えます。
幅と高さのフィールドを変更して、必要に応じてサイズを調整します。最大値は2000です。

トラブルシューティング

ダッシュボードをエクスポートしようとしたときに次のエラーが発生した場合の対処方法は次のとおりです。

New Relic UIから： PDFの作成中にエラーが発生しました。もう一度やり直してください
New Relic NerdGraphから：ダッシュボードエンティティの操作がguid：YOUR_GUIDで失敗しました原因：エラー504がURLでGorgonを呼び出していますhttps://chart-image.service.newrelic.com/dashboard-url-from-guid/YOUR_GUID ：アップストリームリクエストのタイムアウト

これらのエラーは、PDFの生成がAPIの最大応答時間を超える場合に発生する可能性があります。これらのエラーが発生した場合は、ダッシュボードのウィジェットのいずれかに大きな時間枠があるかどうかを確認してください。たとえば、1か月全体のデータと前の月のデータを比較できます。時間枠が大きい場合は、時間枠を小さくしてみてください。

これらのエラーのもう1つの考えられる原因は、ダッシュボードに多数のウィジェットがある可能性があることです。使用しないウィジェットがある場合は、ウィジェットを削除して、エラーが解決するかどうかを確認してください。

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

NerdGraphチュートリアルダッシュボードをファイルとしてエクスポートする

ダッシュボードページのエクスポート

取得したファイルの設定

トラブルシューティング