Prometheusに対するGrafanaのサポート

GrafanaはPrometheusへのクエリをサポートしています。Prometheus用のGrafanaデータソースは、Grafana 2.5.0 (2015-10-28)以降に含まれています。

以下は、Prometheusからデータを取得するGrafanaダッシュボードの例を示しています。

Grafana screenshot

インストール

Grafanaをインストールするには、公式Grafanaドキュメントを参照してください。

使用方法

デフォルトでは、Grafanaはhttp://localhost:3000でリスンします。デフォルトのログインは「admin」/「admin」です。

Prometheusデータソースの作成

GrafanaでPrometheusデータソースを作成するには

  1. サイドバーの「歯車」をクリックして、設定メニューを開きます。
  2. 「データソース」をクリックします。
  3. 「データソースを追加」をクリックします。
  4. タイプとして「Prometheus」を選択します。
  5. 適切なPrometheusサーバーURLを設定します(例:http://localhost:9090/
  6. 必要に応じて、他のデータソース設定を調整します(例:適切なアクセス方法を選択する)。
  7. 「保存とテスト」をクリックして、新しいデータソースを保存します。

以下は、データソース設定の例を示しています。

Data source configuration

Prometheusグラフの作成

標準的な方法で新しいGrafanaグラフを追加します。その後

  1. グラフのタイトルをクリックし、「編集」をクリックします。
  2. 「メトリック」タブで、Prometheusデータソース(右下)を選択します。
  3. オートコンプリートを使用してメトリックを検索しながら、「クエリ」フィールドにPrometheus式を入力します。
  4. タイムシリーズの凡例名をフォーマットするには、「凡例形式」入力を使用します。たとえば、返されたクエリ結果のmethodstatusラベルのみを表示し、ダッシュで区切るには、凡例形式文字列{{method}} - {{status}}を使用できます。
  5. グラフが機能するまで、他のグラフ設定を調整します。

以下は、Prometheusグラフ設定の例を示しています:Prometheusグラフの作成

Grafana 7.2以降では、$__rate_interval変数は推奨され、rate関数とincrease関数で使用されます。

Grafana.comから事前に構築されたダッシュボードのインポート

Grafana.comは、共有ダッシュボードのコレクションを管理しており、これらはダウンロードして、スタンドアロンのGrafanaインスタンスで使用できます。「Prometheus」データソースのみのダッシュボードを参照するには、Grafana.comの「フィルタ」オプションを使用します。

現在、ダウンロードしたJSONファイルを手動で編集し、datasource:エントリを、Prometheusサーバー用に選択したGrafanaデータソース名に反映させる必要があります。「ダッシュボード」→「ホーム」→「インポート」オプションを使用して、編集したダッシュボードファイルをGrafanaインストールにインポートします。

このドキュメントはオープンソースです。問題を報告したり、プルリクエストを送信したりして、改善にご協力ください。