ダッシュボードとグラフのインポート、エクスポート、追加

ダッシュボードを使用すると、システムの健全性を視覚化して追跡し、問題に対処し、さらなるステップを計画することができます。 さまざまなインポートおよびエクスポート オプションを使用して、すべての情報をチーム、顧客、その他の関係者と共有する方法を学びます。

ダッシュボードを JSON としてインポートする

コードレベルですぐに使用できるダッシュボードを変更する場合は、ダッシュボードを JSON としてインポートできます。 たとえば、2 つの既存のダッシュボードを結合してカスタムダッシュボードを作成する場合、ベースのダッシュボードの JSON を変更して、それをNew Relicにインポートし直すことができます。

ダッシュボードを JSON としてインポートするには:

1. one.newrelic.com > All capabilities > Dashboardsに移動します。

2. ...アイコンをクリックして既存のダッシュボードの JSON を開き、 Copy JSONを選択します。

3. Dashboardsページに戻ります。

4. 右上隅にあるImport dashboardをクリックします。

5. JSON コードを貼り付けます。

6. ダッシュボードのアカウントと権限設定を選択します。 一度設定したアカウントを変更することはできませんが、 権限はいつでも変更できます。

7. Saveをクリックします。

ダッシュボードを PDF としてエクスポートする

ダッシュボードを PDF ファイルとしてエクスポートするには、ダッシュボードの右上隅にある...アイコンをクリックし、 Export dashboard as PDFを選択します。

UI経由でダッシュボードをPDFとしてエクスポートする場合は、次の点を考慮してください：

• カスタム視覚化はサポートされていません。

カスタムディメンションやテンプレート変数のオーバーライドなどの追加オプションを使用してPDFまたはPNGとしてエクスポートするには、NerdGraph APIを使用します。

NerdGraph API経由でダッシュボードとチャートをエクスポートする

NerdGraph APIを使用して、ダッシュボードや個々のチャートウィジェットをスナップショット画像としてプログラムでエクスポートします。APIは、カスタムディメンション、テンプレート変数のオーバーライド、エンティティフィルターなど、UIでは利用できないオプションをサポートしています。

ダッシュボードをPDFまたはPNGとしてエクスポート

dashboardCreateSnapshotUrlミューテーションは、ダッシュボードページ全体のスナップショットURLを生成します。

{
  actor {
    entitySearch(
      query: "parentId ='YOUR_DASHBOARD_GUID' AND tags.isDashboardPage = 'true'"
    ) {
      results {
        entities {
          guid
          name
        }
      }
    }
  }
}

Mutation schema：

mutation {
  dashboardCreateSnapshotUrl(
    guid: EntityGuid!
    params: SnapshotUrlInput
  ): String
}

input SnapshotUrlInput {
  timeWindow: SnapshotUrlTimeWindowInput
  display: SnapshotUrlDisplayInput
  variables: [SnapshotUrlVariableInput!]
  filter: String
  format: SnapshotUrlFormat
}

input SnapshotUrlTimeWindowInput {
  beginTime: EpochMilliseconds
  endTime: EpochMilliseconds
  duration: Milliseconds
}

input SnapshotUrlDisplayInput {
  width: Int
  height: Int
}

input SnapshotUrlVariableInput {
  name: String!
  values: [String!]!
}

enum SnapshotUrlFormat {
  PDF
  PNG
}

パラメーターリファレンス：

例：

mutation {
  dashboardCreateSnapshotUrl(guid: "YOUR_DASHBOARD_PAGE_GUID")
}

mutation {
  dashboardCreateSnapshotUrl(
    guid: "YOUR_DASHBOARD_PAGE_GUID"
    params: { format: PNG, display: { width: 1920, height: 1080 } }
  )
}

mutation {
  dashboardCreateSnapshotUrl(
    guid: "YOUR_DASHBOARD_PAGE_GUID"
    params: {
      variables: [
        { name: "environment", values: ["production"] }
        { name: "region", values: ["us-east-1", "eu-west-1"] }
      ]
      filter: "env = 'production' AND service = 'checkout'"
    }
  )
}

チャート画像を取得する

dashboardWidgetCreateSnapshotUrlミューテーションは、単一のチャートウィジェットのPNGスナップショットURLを生成します。ウィジェットがダッシュボード上に存在する必要はありません — インラインで定義できるため、プログラムでチャート画像を生成するのに役立ちます。

Mutation schema：

mutation {
  dashboardWidgetCreateSnapshotUrl(
    widget: DeclarativeUiWidget!
  ): WidgetSnapshotResult
}

type WidgetSnapshotResult {
  url: String!
}

widgetパラメーターはDeclarativeUiWidgetを受け付けます — 3つのネストされたレイヤーを持つJSONオブジェクト：

declarative/widget envelope
└── widget node        ← title and widget-level props
    └── visualization  ← visualization type and configuration

{
  "type": "declarative/widget",
  "version": 1,
  "content": {
    "type": "widget",
    "props": {
      "title": "My Chart Title"
    },
    "content": {
      "type": "visualization",
      "id": "viz.line",
      "props": {
        // visualization-specific config (nrqlQueries, colors, thresholds, etc.)
      }
    }
  }
}

JSONとしてエクスポートしたダッシュボードからウィジェット定義を構築する場合は、次のフィールドマッピングを使用します：

例：

mutation {
  dashboardWidgetCreateSnapshotUrl(
    widget: {
      version: 1
      type: "declarative/widget"
      content: {
        type: "widget"
        props: { title: "Throughput by environment" }
        content: {
          type: "visualization"
          id: "viz.line"
          props: {
            nrqlQueries: [
              {
                accountIds: [YOUR_ACCOUNT_ID]
                query: "SELECT count(*) FROM Transaction TIMESERIES"
              }
            ]
            legend: { enabled: true }
          }
        }
      }
    }
  ) {
    url
  }
}

mutation {
  dashboardWidgetCreateSnapshotUrl(
    widget: {
      version: 1
      type: "declarative/widget"
      content: {
        type: "widget"
        props: { title: "Error rate" }
        content: {
          type: "visualization"
          id: "viz.billboard"
          props: {
            nrqlQueries: [
              {
                accountIds: [YOUR_ACCOUNT_ID]
                query: "SELECT percentage(count(*), WHERE error IS true) AS 'Error rate' FROM Transaction SINCE 1 hour ago"
              }
            ]
            thresholds: [
              { alertSeverity: "WARNING", value: 1 }
              { alertSeverity: "CRITICAL", value: 5 }
            ]
          }
        }
      }
    }
  ) {
    url
  }
}

チャートをCSVとしてエクスポート

ダッシュボードのテーブル チャートを CSV ファイルとしてエクスポートするには、チャートの右上隅で...をクリックし、 Export as CSVを選択します。

チャートを CSV としてエクスポートする場合は、次の点に注意してください。

• データは常にUTC時間でエクスポートされます
• エクスポートは、次のようなアグリゲータ関数をサポートしていません。 average()
• エクスポートはCOMPARE_WITH句をサポートしていません
• シナリオによっては、UI がエクスポートされた CSV に複製されていないデータの追加フォーマットを実行し、小さな不一致が生じる可能性があります (たとえば、-1.1E-17 が UI では 0 としてレンダリングされるが、CSV では 0 としてレンダリングされないなど)。
• クロスアカウントクエリの結果をエクスポートすることはできません。

チャートのクエリと探索

グラフでできることの詳細については、 「クエリとグラフのオプション」を参照してください。