すべてのプロダクト
Search

このプロダクト

    Managed Service for Prometheus:HTTP API URL を使用した、セルフマネージド Grafana システムまたはカスタムアプリケーションでの Prometheus データへのアクセス

    ドキュメントセンター

    Managed Service for Prometheus:HTTP API URL を使用した、セルフマネージド Grafana システムまたはカスタムアプリケーションでの Prometheus データへのアクセス

    最終更新日:Dec 04, 2025

    Managed Service for Prometheus は HTTP API URL を提供します。これらの URL を使用して、セルフマネージド Grafana システムで Prometheus のモニタリングデータにアクセスしたり、Prometheus API を使用してカスタム開発のためにモニタリングデータを取得したりできます。

    前提条件

    Prometheus インスタンスが接続済みであること。詳細については、次の Topic をご参照ください：

    ステップ 1：HTTP API URL の取得

    1. Cloud Monitor コンソールにログインします。左側のナビゲーションウィンドウで、[Managed Service For Prometheus] > [インスタンス] を選択します。[インスタンス] ページが表示されます。

    2. 上部のナビゲーションバーで、ご利用の Prometheus インスタンスがデプロイされているリージョンを選択し、対象の Prometheus インスタンスを見つけて、[操作] 列の [設定] をクリックします。

    3. [設定] タブで、パブリックまたは内部 HTTP API URL をコピーします。

      image

    4. オプション。Prometheus V1 インスタンスの場合は、[トークンを生成] をクリックして認証トークンを取得します。このトークンは、モニタリングデータを Grafana にインポートする際のデータセキュリティを確保するために使用されます。

      重要

      • Prometheus V1 インスタンスの場合：認証トークンを生成した後、Prometheus インスタンスをデータソースとして Grafana システムに追加する際に、このトークンを指定する必要があります。そうしないと、Prometheus インスタンスからモニタリングデータを読み取ることができません。

      • Prometheus V2 インスタンスの場合：デフォルトでは、データアクセスにはアカウントの AccessKey ID と AccessKey Secret の両方が必要です。また、関連付けられた RAM ユーザーは、AliyunPrometheusMetricReadAccess または AliyunCloudMonitorFullAccess のシステム権限を持っている必要があります。

    ステップ 2：セルフマネージド Grafana システムへの HTTP API URL の追加

    1. Grafana システムでデータソースを設定します。

      1. 管理者として Grafana システムにログインします。

      2. ページの左上隅にある image アイコンをクリックします。

      3. 左側のナビゲーションウィンドウで、[Configuration] > [Data Sources] を選択します。

        説明

        このメニューは管理者のみに表示されます。

      4. [Data Sources] タブで、[+ Add Data Source] をクリックします。

      5. [Add Data Source] ページで、[Prometheus] をクリックします。

      6. [Settings] タブで、[Name] フィールドにダッシュボード名を入力し、HTTP セクションの [Prometheus Server URL] フィールドにステップ 1：HTTP API URL の取得で取得した Prometheus サーバーの URL を入力します。

      7. セキュリティ強化を設定します。

        Prometheus V1 (オプション)

        トークンを生成した場合、[Custom HTTP Headers] セクションで [+ Add Header] をクリックし、[Header] パラメーターを [Authorization] に設定し、[Value] パラメーターをステップ 1：HTTP API URL の取得で生成したトークンに設定します。

        image

        Prometheus V2

        [Basic Auth] をオンにします。[User] パラメーターをご利用の AccessKey ID に設定し、[Password] パラメーターをご利用の AccessKey Secret に設定します。

        image

    2. [Save & Test] をクリックします。

    3. 結果を検証します。

      1. Grafana システムにログインします。

      2. ページの左上隅にある image アイコンをクリックし、左側のナビゲーションウィンドウで [Dashboards] をクリックします。

      3. [Dashboards] ページで [New] をクリックし、ドロップダウンメニューから [New Dashboard] をクリックします。

      4. [+ Add Visualization] をクリックします。

      5. [Select Data Source] ページで、カスタムデータソースを選択します。

      6. [Edit Panel] ページで、[Query] タブの [A] セクションにある [Metrics] フィールドと [Label Filters] フィールドにメトリック名と値を入力し、[Run Queries] をクリックします。

        メトリックのチャートが表示された場合、Prometheus データソースは正常に追加されています。チャートが表示されない場合、Prometheus データソースの追加は失敗しています。API URL またはトークンが有効であるか、およびデータソースにモニタリングデータがあるかどうかを確認してください。

        image

    ステップ 3：Prometheus モニタリングデータの取得

    次のコードは、Prometheus モニタリングデータを取得するためのリクエストの例です。HTTP API を使用して Prometheus モニタリングデータを取得する方法の詳細については、「Prometheus HTTP API」をご参照ください。

    Prometheus V1

    GET {HTTP API}/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} を実際の HTTP API URL に、{Token} を実際の認証トークンに置き換えてください。詳細については、「ステップ 1：HTTP API URL の取得」をご参照ください。

    Prometheus V2

    GET {HTTP API}/api/v1/query

Accept: application/json
Content-Type: application/json
Authorization: Basic <base64Encode(<accessKey:secretKey>)>

{
  "query":"arms_prometheus_target_interval_length_seconds_sum",
  "time":"1635302655",
  "timeout":"1000"

}
    説明

    上記のコードの {HTTP API} をステップ 1：HTTP API URL の取得で取得した HTTP API URL に置き換えてください。

    応答サンプル：

    応答サンプルの表示

    {
    "status": "success",
    "data": {
        "resultType": "vector",
        "result": [
            {
                "metric": {
                    "__name__": "arms_prometheus_target_interval_length_seconds_sum",
                    "instance": "localhost:9335",
                    "interval": "15s",
                    "job": "_arms-prom/kubelet/1"
                },
                "value": [
                    1635302655,
                    "146655.24420603***"
                ]
            },
            {
                "metric": {
                    "__name__": "arms_prometheus_target_interval_length_seconds_sum",
                    "instance": "localhost:9335",
                    "interval": "30s",
                    "job": "_arms-prom/kubelet/1"
                },
                "value": [
                    1635302655,
                    "879810.747346***"
                ]
            },
            {
                "metric": {
                    "__name__": "arms_prometheus_target_interval_length_seconds_sum",
                    "instance": "localhost:9335",
                    "interval": "20s",
                    "job": "_arms-prom/kubelet/1"
                },
                "value": [
                    1635302655,
                    "73320.13578499***"
                ]
            }
        ]
    }