すべてのプロダクト
Search

このプロダクト

    Simple Log Service:Metricstore 間のクエリ

    ドキュメントセンター

    Simple Log Service:Metricstore 間のクエリ

    最終更新日:Jun 18, 2026

    Metricstore の StoreView を使用すると、複数の Metricstore 間でデータをクエリできます。PromQL を使用して StoreView 内のデータをクエリしたり、StoreView を Grafana に接続したり、API を使用して StoreView 情報を取得したりできます。

    前提条件

    プロジェクトおよび Metricstore が作成済みである必要があります。詳細については、「プロジェクトの管理」および「Metricstore の管理」をご参照ください。

    StoreView の作成と Metricstore の関連付け

    1. Metricstore の StoreView の作成

    1. Simple Log Service コンソールにログインします。プロジェクト一覧リストで、対象のプロジェクトをクリックします。

    2. 左側のナビゲーションウィンドウで、データビュー > 時系列タイプのデータビューを選択します。StoreView ページで、image をクリックして Metricstore の StoreView を作成します。

    3. [StoreView の作成] パネルで、StoreView 名を入力し、関連付けるMetricstoreを追加してから、OK をクリックします。

      重要

      • Metricstore の StoreView には、同じプロジェクト内の Metricstore を少なくとも 1 つ含める必要があります。

      • Metricstore の StoreView は、複数の Metricstore 間でのクエリと分析をサポートします。正確な結果を得るため、以下の推奨事項に従ってください。

        • 同じ StoreView に、重複する時系列を持つ Metricstore を関連付けないでください。

        • 計算のために複数の大規模な Metricstore を関連付けないでください。たとえば、Shard Count が 64 を超える Metricstore の関連付けは避けてください。

      StoreView タイプをMetricに設定します。

    2. PromQL による StoreView のクエリ

    説明

    • 複数の Metricstore を StoreView に関連付けた場合、クエリと分析の結果は、関連付けられたすべての Metricstore から集約されます。

    • Metricstore の StoreView は SQL または事前定義された処理をサポートしません。クエリエディターに直接PromQL 文を入力してください。バックエンドエンジンが自動的に、関連付けられたすべての Metricstore 間で計算を実行します。

    左側のデータセットパネルで、test データセットを選択します。クエリエディターに PromQL 文 cpu_count{} を入力し、右上隅の [実行] をクリックします。メトリックの折れ線グラフが結果エリアに表示されます。

    StoreView の Grafana への接続

    1. Grafana をインストールしてログインします。左側のナビゲーションウィンドウで、[設定] > [データソース] を選択します。

    2. データソースタブで、[データソースの追加] をクリックします。次に、Prometheus を選択して、[選択] をクリックします。

    3. [設定項目] タブで、データソースを構成します。

      データソースのパラメーター

      パラメーター

      説明

      Name

      データソースのカスタム名を入力します。例：Prometheus-1。

      HTTP

      • URL：Simple Log Service の StoreView の URL。形式は https://{project}.{sls-endpoint}/prometheus/{project}/{storeview} です。{sls-endpoint} は、プロジェクトが配置されているリージョンのエンドポイントに置き換えます。{project} および {storeview} は、ご利用のプロジェクト名および StoreView 名に置き換えます。例：https://sls-prometheus-test.cn-hangzhou.log.aliyuncs.com/prometheus/sls-prometheus-test/test。

        説明

        安全なデータ転送を確保するため、必ず https を使用する必要があります。

      • Whitelisted Cookies：オプション。リクエストの許可リストに Cookie を追加します。

      Auth

      Basic auth スイッチをオンにします。

      Basic Auth Details

      • User：Alibaba Cloud アカウントの AccessKey ID。

      • Password：Alibaba Cloud アカウントの AccessKey Secret。

      指定されたプロジェクトに対する読み取り専用権限を持つ RAM ユーザーの AccessKey ペアを使用することを推奨します。詳細については、「特定のプロジェクトに対する読み取り専用権限の付与」をご参照ください。

    4. [保存してテスト] をクリックします。

    StoreView HTTP API

    概要

    Simple Log Service は、Metricstore の StoreView をクエリするための複数の API を提供しています。これらの API はオープンソースのPrometheus プロトコルと互換性があり、同じ /api/v1 ディレクトリ規則に従っています。完全な URL は https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/ です。

    パラメーター

    必須

    説明

    {project}

    はい

    Simple Log Service プロジェクトの名前。詳細については、「プロジェクトの管理」をご参照ください。

    {sls-endpoint}

    はい

    プロジェクトが配置されているリージョンのエンドポイント。

    {storeview}

    はい

    StoreView の名前。

    Metric クエリ API

    インスタントクエリ

    インスタントクエリ API は、特定の時点におけるメトリックデータをクエリします。

    GET https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/query
POST https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/query

    以下の表は、パラメーターの説明です。

    パラメーター

    必須

    説明

    query

    はい

    PromQL 式。詳細については、「PromQL 構文」をご参照ください。

    time

    いいえ

    クエリの評価タイムスタンプ。UNIX タイムスタンプ（秒単位）で指定します。デフォルトは現在時刻です。

    timeout

    いいえ

    クエリのタイムアウト。

    値は秒単位、または 1s、2m、3h のような時間持続フォーマット（例：timeout=10s）で指定します。詳細については、「Time Durations」をご参照ください。

    lookback_delta

    いいえ

    Prometheus の query.lookback-delta フラグをクエリごとにカスタマイズします。PromQL 評価中にデータポイントを検索する最大ルックバック期間を定義します。値は時間持続フォーマットで指定する必要があります（例：lookback_delta=1m）。Log Service 時系列データベースでのデフォルト値は 3m です。詳細については、「Time Durations」をご参照ください。

    範囲クエリ

    レンジクエリ API は、指定された時間範囲内のメトリックデータをクエリします。

    GET https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/query_range
POST https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/query_range

    以下の表は、パラメーターの説明です。

    パラメーター

    必須

    説明

    query

    はい

    PromQL 式。詳細については、「PromQL 構文」をご参照ください。

    start

    いいえ

    クエリ範囲の開始時刻。UNIX タイムスタンプ（秒単位）で指定します。

    end

    いいえ

    クエリ範囲の終了時刻。UNIX タイムスタンプ（秒単位）で指定します。

    step

    いいえ

    クエリ解決ステップ（単位：秒）。

    1s、2m、3h のような時間持続フォーマットも使用できます（例：step=2m）。詳細については、「Time Durations」をご参照ください。

    timeout

    いいえ

    クエリのタイムアウト。

    値は秒単位、または 1s、2m、3h のような時間持続フォーマットで指定できます（例：timeout=10s）。詳細については、「Time Durations」をご参照ください。

    lookback_delta

    いいえ

    Prometheus の query.lookback-delta フラグをクエリごとにカスタマイズします。PromQL 評価中にデータポイントを検索する最大ルックバック期間を定義します。値は時間持続フォーマットで指定する必要があります（例：lookback_delta=1m）。Log Service 時系列データベースでのデフォルト値は 3m です。詳細については、「Time Durations」をご参照ください。

    構成例については、「Metric クエリ API」をご参照ください。

    メタデータクエリ API

    クエリシリーズ

    シリーズクエリ API は、指定された時間範囲内で一連のラベルセレクターに一致するすべての時系列およびラベルを返します。

    GET https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/series
POST https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/series

    以下の表は、パラメーターの説明です。

    パラメーター

    必須

    説明

    match[]

    はい

    一致させるシリーズセレクター。例：match[]=up{instance="demo.*"}。

    match[] パラメーターを 1 つ以上指定できます。

    start

    いいえ

    クエリ範囲の開始時刻（UNIX タイムスタンプ、秒単位）。

    デフォルトは現在時刻の 5 分前です。

    end

    いいえ

    クエリ範囲の終了時刻（UNIX タイムスタンプ、秒単位）。

    デフォルトは現在時刻です。

    重要

    start および end パラメーターの両方にカスタム値を指定した場合、API はクエリを end 時刻の直前の 5 分間隔に制限します。有効なクエリ範囲は [end - 5 分, end] になります。

    x-sls-disable-range-limit

    いいえ

    true の場合、このパラメーターは 5 分間のクエリ制限をバイパスし、start および end で指定された全範囲を使用します。

    forceMaxMetaTimeRangeSeconds

    いいえ

    クエリの最大時間範囲を秒単位で指定します。end と start の間の時間がこの値を超える場合、クエリ範囲は (end - forceMaxMetaTimeRangeSeconds, end) に調整されます。

    効率的なクエリを確保するため、このパラメーターを含めることを推奨します。

    ラベル名のクエリ

    指定された時間範囲内で条件を満たすすべてのラベル名をクエリします。

    GET https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/labels
POST https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/labels

    以下の表は、パラメーターの説明です。

    パラメーター

    必須

    説明

    match[]

    はい

    一致させるシリーズセレクター。例：match[]=up{instance="demo.*"}。

    match[] パラメーターを 0 個、1 個、または複数指定できます。

    start

    いいえ

    クエリ範囲の開始時刻（UNIX タイムスタンプ、秒単位）。

    デフォルトは現在時刻の 5 分前です。

    end

    いいえ

    クエリ範囲の終了時刻（UNIX タイムスタンプ、秒単位）。

    デフォルトは現在時刻です。

    重要

    start および end パラメーターの両方にカスタム値を指定した場合、API はクエリを end 時刻の直前の 5 分間隔に制限します。有効なクエリ範囲は [end - 5 分, end] になります。

    x-sls-disable-range-limit

    いいえ

    true の場合、このパラメーターは 5 分間のクエリ制限をバイパスし、start および end で指定された全範囲を使用します。

    forceMaxMetaTimeRangeSeconds

    いいえ

    クエリの最大時間範囲を秒単位で指定します。end と start の間の時間がこの値を超える場合、クエリ範囲は (end - forceMaxMetaTimeRangeSeconds, end) に調整されます。

    効率的なクエリを確保するため、このパラメーターを含めることを推奨します。

    ラベル値のクエリ

    ラベル値クエリ API は、指定された時間範囲内で特定のセレクターに一致する特定のラベルのすべての値を返します。

    重要

    API URL 内の <label_name> は、具体的なラベル名に置き換える必要があります。

    GET https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/label/<label_name>/values

    以下の表は、パラメーターの説明です。

    パラメーター

    必須

    説明

    match[]

    はい

    一致させるシリーズセレクター。例：match[]=up{instance="demo.*"}。

    match[] パラメーターを 1 つ以上指定できます。

    start

    いいえ

    クエリ範囲の開始時刻（UNIX タイムスタンプ、秒単位）。

    デフォルトは現在時刻の 5 分前です。

    end

    いいえ

    クエリ範囲の終了時刻（UNIX タイムスタンプ、秒単位）。

    デフォルトは現在時刻です。

    重要

    start および end パラメーターの両方にカスタム値を指定した場合、API はクエリを end 時刻の直前の 5 分間隔に制限します。有効なクエリ範囲は [end - 5 分, end] になります。

    x-sls-disable-range-limit

    いいえ

    true の場合、このパラメーターは 5 分間のクエリ制限をバイパスし、start および end で指定された全範囲を使用します。

    forceMaxMetaTimeRangeSeconds

    いいえ

    クエリの最大時間範囲を秒単位で指定します。end と start の間の時間がこの値を超える場合、クエリ範囲は (end - forceMaxMetaTimeRangeSeconds, end) に調整されます。

    効率的なクエリを確保するため、このパラメーターを含めることを推奨します。

    構成例については、「メタデータクエリ API」をご参照ください。

    次のステップ

    StoreView のクエリ

    左側のナビゲーションウィンドウで、データビュー > 時系列タイプのデータビュー を選択して、作成済みの StoreView を表示します。

    StoreView の更新

    1. StoreView リストで、対象の StoreView 上にカーソルを合わせ、image アイコンをクリックしてから、変更 をクリックします。

    2. [StoreView の変更] パネルで、関連付けられている Metricstore を変更してから、OK をクリックします。

      各ストアには プロジェクト および Metricstore のドロップダウンリストが含まれています。+ STORE をクリックして、さらに Metricstore を関連付けられます。

    StoreView の削除

    StoreView リストで、対象の StoreView 上にカーソルを合わせ、image アイコンをクリックしてから、[削除] をクリックします。

    関連ドキュメント