Managed Service for Prometheus は HTTP API URL を提供します。この URL を使用することで、Grafana から Prometheus のモニタリングデータにアクセスしたり、カスタム開発向けに Prometheus API を使用してデータを取得したりできます。
前提条件
Prometheus でデータソースを統合していること。詳細については、次のトピックをご参照ください。
手順 1:HTTP API URL の取得
-
CloudMonitor コンソールにログインします。 左側のナビゲーションウィンドウで、[Prometheus モニタリング] > [インスタンスリスト] を選択して [インスタンスリスト] ページに移動します。
-
上部のナビゲーションバーで、Prometheus インスタンスがデプロイされている Prometheus を選択します。対象のインスタンスを見つけ、[アクション] 列の [設定] をクリックします。
-
[設定] タブで、必要に応じてパブリックネットワークまたは内部ネットワーク用の HTTP API URL をコピーします。
データ読み取りのセキュリティを強化するには、[トークンを生成] をクリックすることもできます。
-
V1 Prometheus インスタンスでは、Grafana でのデータ読み取りのセキュリティを向上させるには、[トークンを生成] をクリックして Prometheus インスタンスの認証トークンを取得します。
重要-
V1 インスタンス:トークンを生成した後、Grafana にデータソースを追加する際にトークンを設定する必要があります。設定しない場合、Prometheus インスタンスからモニタリングデータを読み取れません。
-
V2 インスタンス:デフォルトでは、アカウントの AccessKey ID と AccessKey secret を使用してデータにアクセスする必要があります。AccessKey ID を所有する RAM ユーザーには、AliyunPrometheusMetricReadAccess または AliyunCloudMonitorFullAccess のシステム権限が必要です。
-
手順 2:Grafana へのデータソースの追加
セルフマネージド Grafana
このセクションでは、Grafana v10.x を例に説明します。他のバージョンでデータソースを追加する方法については、Grafana 公式ドキュメントをご参照ください。
-
Grafana データソースを設定します。
-
管理者としてセルフマネージド Grafana にログインします。
-
ページの左上隅で、
メニューアイコンをクリックし、[管理] > [データソース] を選択します。 -
[+ 新しいデータソースを追加]をクリックし、データソースタイプとして [Prometheus] を選択します。
-
[設定] タブで、[名前] フィールドにカスタム名を入力します。[Prometheus サーバー URL] フィールドに、ステップ 1 で取得した HTTP API URL を貼り付けます。
-
認証を設定します。
V1 インスタンス (任意)
[+ ヘッダーの追加] をクリックします。[カスタム HTTP ヘッダー] セクションで [+ヘッダーの追加] をクリックし、[ヘッダー] を [Authorization] に、値 を ステップ 1 で取得した認証トークンに設定します。
V2 インスタンス
[基本認証] を有効にします。[ユーザー] に AccessKey ID を、パスワードに AccessKey シークレットを設定します。
-
-
ページの下部で、[保存してテスト] をクリックします。
-
Prometheus メトリクスをクエリします。
-
Grafana システムにログインします。
-
ページの左上隅にある
メニューアイコンをクリックし、次に左側のナビゲーションペインで[ダッシュボード]をクリックします。 -
[ダッシュボード] ページで、右上隅の [新規] をクリックし、ドロップダウンメニューの [新規ダッシュボード] をクリックします。
-
[+ ビジュアライゼーションの追加] をクリックします。[データソースの選択] ページで、作成したデータソースを選択します。
-
On the Edit Panel page, go to the Query tab. In section A, enter the metric name and value in the Metrics and Label filters fields, and then click Run queries.
If a chart for the metric appears, the setup is successful. Otherwise, verify that the API URL and token are correct and that the data source contains Prometheus monitoring data.

-
Managed Service for Grafana
Managed Service for Grafana は、Prometheus データソースとダッシュボードのワンクリック統合を提供します。
-
ARMS コンソールにログインします。左側のナビゲーションウィンドウで、[Grafana 向けマネージドサービス] > [ワークスペース管理] を選択し、お使いのワークスペース ID をクリックします。
-
[ワークスペース情報] ページで [クラウドサービス統合] セクションを見つけ、[Prometheus モニタリングサービス] をクリックします。次に、お使いのインスタンスを見つけて [統合] をクリックします。
-
表示されるダイアログボックスで [OK] をクリックします。
V2 Prometheus インスタンスを統合する場合は、データソースの AccessKey ID を入力する必要があります。
-
同期が完了すると、右側の [フォルダー] アイコンをクリックします。
-
Grafana の [ダッシュボード] タブで、ダッシュボード名をクリックすると、アプリケーション監視用の事前構築済みデフォルトダッシュボードが表示されます。
-
ページの左上隅で、
メニューアイコンをクリックし、[管理] > [データソース] を選択すると、追加されたアプリケーション監視データソースを表示できます。 -
Prometheus メトリクスをクエリします。
-
Grafana システムにログインします。
-
ページの左上隅にある
メニューアイコンをクリックし、左側のナビゲーションペインで[ダッシュボード]をクリックします。 -
[ダッシュボード] ページで、右上隅にある [新規] をクリックし、ドロップダウンメニューで [新規ダッシュボード] をクリックします。
-
[+ビジュアライゼーションの追加] をクリックします。[データソースの選択] ページで、作成したデータソースを選択します。
-
[編集パネル] ページで [クエリ] タブに移動し、セクション A で、[メトリック] および [ラベルフィルター] フィールドにメトリック名と値を入力し、[クエリを実行] をクリックします。
メトリクスのチャートが表示される場合、設定は成功です。表示されない場合は、API URL とトークンが正しいこと、およびデータソースに Prometheus のモニタリングデータが含まれていることを確認してください。

-
手順 3:Prometheus データの取得
次のコードは、Prometheus モニタリングデータを取得するためのサンプルリクエストを示しています。 HTTP API の使用方法の詳細については、「オープンソースの Prometheus HTTP API ドキュメント」をご参照ください。
V1 インスタンス
GET {HTTP API URL}/api/v1/query
Accept: application/json
Content-Type: application/json
Authorization: {Token}
{
"query":"arms_prometheus_target_interval_length_seconds_sum",
"time":"1635302655",
"timeout":"1000"
}
{HTTP API URL} と {Token} を、ステップ 1 で取得した HTTP API URL と認証トークンに置き換えます。
V2 インスタンス
GET {HTTP API URL}/api/v1/query
Accept: application/json
Content-Type: application/json
Authorization: Basic <base64Encode(<AccessKey ID:AccessKey secret>)>
{
"query":"arms_prometheus_target_interval_length_seconds_sum",
"time":"1635302655",
"timeout":"1000"
}
レスポンス例: