グラフやダッシュボードを含むレポートをスケジュールする必要がありますか? ダッシュボードの共有方法を自動化したいですか? GraphQLミューテーションを使用して、プログラムでを PDF または PNG ファイルとして取得できます。 UI を使用してダッシュボードを PDF ファイルとしてエクスポートすることもできます。
たとえば、New Relic ダッシュボードの静的な スナップショット バージョンを 生成し、それらを Slack に送信したり、 ファイルとしてダウンロードしたりできます。
ダッシュボードページのエクスポート
ダッシュボードの GUID を取得します。 ダッシュボード名の横にある アイコンをクリックしてメタデータ ウィジェットにアクセスし、ダッシュボードの GUID を確認します。
以下のクエリを使用して、個々のページのGUIDを取得します。
{actor {entitySearch(query: "id ='YOUR_PAGE_GUID' OR parentId ='YOUR_PAGE_GUID' AND tags.isDashboardPage = 'true'") {results {entities {guidname... on DashboardEntityOutline {guidnamedashboardParentGuid}}}}}}エクスポートするダッシュボード ページの数だけ、 NerdGraphQL エクスプローラーでdashboardCreateSnapshotURLミューテーションを実行します。 必要なダッシュボード ページの 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から: We ran into an error while creating the PDF. Please try again
- New Relic NerdGraphより: Operation on dashboard entity failed with guid:YOUR_GUID with cause: Error 504 calling Gorgon with url https://chart-image.service.newrelic.com/dashboard-url-from-guid/YOUR_GUID: upstream request timeout
これらのエラーは、PDFの生成がAPIの最大応答時間を超える場合に発生する可能性があります。これらのエラーが発生した場合は、ダッシュボードのウィジェットのいずれかに大きな時間枠があるかどうかを確認してください。たとえば、1か月全体のデータと前の月のデータを比較できます。時間枠が大きい場合は、時間枠を小さくしてみてください。
これらのエラーのもう 1 つの原因として、ダッシュボードに多数のウィジェットがあることが考えられます。使用しないウィジェットがある場合は、いくつかを削除してエラーが解決するかどうかを確認してください。