New RelicをGrafanaのPrometheusデータソースとして設定

GrafanaPrometheusデータソースの設定を行い、PromQLスタイルクエリ言語を使用してNew Relicデータベース(NRDB)に保存されたデータのクエリを行えます。

Prometheusデータソースを追加する

次のステップに従い、GrafanaのPrometheusデータソースとしてNew Relicを追加します。

設定プロセスを開始する前に、Prometheusリモート書込みインテグレーションプロセスを完了する必要があります。

以下では、Grafanaバージョン6.7以上で作業を行う際にプロセスを完了する方法を詳細に説明します。

  1. New Relicで、新規のクエリキーを作成します

    注: Grafanaで、このキーをカスタムのX-Query-Key HTTPヘッダーに入れる必要がありますが(以下のステップ7を参照)、これはNew Relic Queryキーと同じエンティティです。

  2. Grafanaホーム画面から、設定 > データソースと進み、データソースの追加をクリックします。
  3. 時系列データベースオプションの下にあるデータソースの追加スクリーンからPrometheusを選択します。
  4. 新規Prometheusデータソースの任意の名前を入力します。
  5. ONまたはOFF位置にデフォルトのトグルを設定します。これをPrometheusクエリのデフォルトデータソースにするかどうかによってどちらかに設定されます。
    • Off: デフォルトのデータソースにしない
    • On: デフォルトのデータソースにする
  6. URLを正しく入力します。
  7. カスタムヘッダーの下で、ヘッダーを追加を選択します。ヘッダー名をX-Query-Keyに設定します。は、ステップ1で作成したクエリキーを入力します。
  8. 保存とテストをクリックします。

線グラフがつながった線ではなく一連の点で表示される場合、Graphanaのグラフパネルを変更し、スタッキングとnull値 > 接続を選択できます。

New Relicでは、バージョン6.7.x以上を使用し、PrometheusデータソースとしてNew Relicを設定することを強く推奨しています。以前のバージョンを実行して設定を完了することを選択する場合、次の1つを実行してデータソースを正常に設定する必要があります。

  • 基本的な認証を使用するよう新規データソースを設定してしてから、基本的な認証ワークフローのパスワードとしてクエリキーを入力します。
  • クエリキーを含めるよう、新規データソースURLを設定します:https://prometheus-api.newrelic.com/auth/`<query-key>`
サンプル設定の画像
Grafanaでのデータソースワークフロー追加のスクリーンキャプチャ
dbarnesbrown.newrelic.comによる、Grafana Data Source Config.png

Prometheus APIの動作をカスタマイズする

リモート書込みインテグレーションを使用して、複数のPrometheusサーバをNew Relicに接続している場合、ヘッダーは特に重要です。カスタマイズの詳細は次のとおりです。

X-Query-Key(クエリキー)

New Relicで認証を行い、メトリックスを含むアカウントを特定するには、クエリキーパラメーターが必要です。GrafanaではこれはX-クエリキーと呼ばれますが、New Relic UIではクエリキーと表示されます。

詳細:

  • 必須
  • 認証に使用するAPIクエリキー
  • Prometheusリモート書込みインテグレーションを使用している場合、X-クエリキーは、リモート書込みの統合に使用したX-ライセンスキーと同じアカウントに対応している必要があります。
X-Prometheus-Only

Grafanaの自動完了サポートでは、Prometheus命名規則に厳格に従えないメトリックスは扱いません。New Relicでは、このパラメーターに従わないメトリックスを含めないことを推奨しています。

詳細:

  • オプション
  • APIによりさらされるメトリックスを、Prometheusからのメトリックスに制限します
  • デフォルト = 指定されていない場合にはtrue
X-Prometheus-Server

このパラメーターは、複数のPrometheusサーバーからメトリックスを収集している場合に有用です。たとえば、Grafanaを使用している場合、New Relicに接続している各Prometheusサーバーのデータソースを作成してから、すべてのPrometheusサーバーでのクエリに使用できる別のデータソースを作成できます。

詳細:

  • オプション
  • APIによりさらされるメトリックスを、指定したPrometheusサーバーから収集したメトリックスに限定します
  • この値は、PrometheusサーバーをNew Relicに接続するのに使用したリモート書込みURLのprometheus_server URLと一致する必要があります
  • デフォルトで、すべてのサーバーから収集したメトリックスを返します

Prometheusデータソースを削除する

Grafanaでデータソースを削除するには:

  1. 設定 > データソースの順に移動します。
  2. 削除するデータソースをクリックします。
  3. ページの下にある削除ボタンをクリックします。

その他のヘルプ

さらに支援が必要な場合は、これらのサポートと学習リソースを確認してください: