すべてのプロダクト
Search

このプロダクト

    :Metricstores間のログの照会

    ドキュメントセンター

    :Metricstores間のログの照会

    最終更新日:Dec 16, 2024

    MetricstoreのStoreviewを使用すると、Metricstore間のログに対してJOINクエリを実行できます。 このトピックでは、PromQLステートメントを使用してStoreviewのデータを照会し、StoreviewをGrafanaに接続し、API操作を呼び出してStoreview情報を取得する方法について説明します。

    前提条件

    プロジェクトとMetricstoreが作成されます。 詳細については、「プロジェクトの管理」および「Metricstoreの管理」をご参照ください。

    MetricstoreのStoreviewを作成し、Metricstoresを関連付ける

    1. MetricstoreのStoreviewを作成する

    1. Simple Log Serviceコンソールにログインします。 [プロジェクト] セクションで、管理するプロジェクトをクリックします。

    2. 左側のナビゲーションウィンドウで、[Storeview] > [Storeview for Metricstore] を選択します。 表示されるページで、アイコンをクリックしimageてMetricstoreのStoreviewを作成します。

      image

    3. [Storeviewの作成] パネルで、[Storeview Name] パラメーターを指定し、Storeviewに関連付ける [Metricstores] を追加して、[OK] をクリックします。

      重要

      MetricstoreのStoreviewを使用すると、Metricstore間のログに対してJOINクエリと分析を実行できます。 クエリおよび分析結果の正確性を確保するために、次の項目に注意してください。

      • 重複するタイムラインを持つMetricstoreを同じStoreviewに関連付けないことを推奨します。

      • 大量のデータを格納する複数のMetricstoreを関連付けて計算を実行しないことをお勧めします。 たとえば、Metricstoreのシャードの数は64を超えています。

      image

    2. PromQLステートメントを使用してStoreviewを照会する

    説明

    • 複数のMetricstoreをMetricstoreのStoreviewに関連付けた後、複数のMetricstoreにわたるクエリおよび分析結果を表示できます。

    • MetricstoreのStoreviewsは、SQL文と定義済みの処理をサポートしません。 検索ボックスにPromQLステートメントを直接入力できます。 バックエンドコンピューティングエンジンは、複数のMetricstoreにわたって計算を自動的に実行します。 詳細については、「PromQL」をご参照ください。

    image

    MetricstoreのStoreviewをGrafanaに接続

    1. Grafanaをインストールし、Grafanaにログインします。 詳細については、「Grafanaのインストール」をご参照ください。 左側のナビゲーションウィンドウで、[設定] > [データソース] を選択します。

    2. [データソース] タブで、[データソースの追加] をクリックします。 プロメテウスを選択し、[選択] をクリックします。

    3. [設定] タブで、パラメーターを設定します。 下表にパラメーターを示します。

      image

      パラメーター

      パラメーター

      説明

      名前

      ビジネス要件に基づいてデータソースの名前を指定します。 例: プロメテウス-1。

      HTTP

      • URL: https://{project}.{sls-endpoint}/prometheus/{project}/{Storeview} 形式でstoreviewのURLを入力します。 {sls-enpoint} パラメーターを、Simple Log Serviceプロジェクトが存在するリージョンのエンドポイントに置き換えます。 {project} および {storeview} パラメーターを、ビジネス要件に基づいてプロジェクト名およびStoreview名に置き換えます。 詳細については、「エンドポイント」をご参照ください。 例: https://sls-prometheus-test.cn-hangzhou.log.aliyuncs.com/prometheus/sls-prometheus-test/test 。

        説明

        送信のセキュリティを確保するには、httpsを使用する必要があります。

      • ホワイトリストのCookie: ホワイトリストを追加します。 このパラメーターはオプションです。

      認証

      [基本認証] をオンにします。

      基本的な認証の詳細

      • ユーザー: Alibaba CloudアカウントのAccessKey IDを入力します。

      • パスワード: AccessKey IDに対応するAccessKeyシークレットを入力します。

      Simple Log Serviceプロジェクトの読み取り専用権限のみを持つResource Access Management (RAM) ユーザーのAccessKeyペアを使用することを推奨します。 詳細については、「プロジェクトに対する読み取り専用権限」をご参照ください。

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

    Storeview HTTP API

    概要

    Simple Log Serviceは、MetricstoreのStoreviewのクエリに使用できる複数のAPI操作を提供します。 API操作は、オープンソースのPrometheusプロトコルと互換性があります。 Prometheusによって提供されるAPI操作は、/api/v1ディレクトリに格納されます。 Simple Log Serviceによって提供されるStoreview関連のAPI操作も、/api/v1ディレクトリに保存されます。 次のURLを使用して、Simple Log Serviceが提供するStoreview関連のAPI操作を呼び出すことができます: https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1 /。 詳細については、「HTTP API」をご参照ください。次の表にパラメーターを示します。

    パラメーター

    必須 / 任意

    説明

    {project}

    対象

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

    {sls-endpoint}

    対象

    Simple Log Serviceプロジェクトが存在するリージョンのエンドポイント。 詳細は、「エンドポイント」をご参照ください。

    {storeview}

    対象

    作成したStoreview。

    時系列メトリックを照会するためのAPI操作

    インスタントクエリAPI

    Instant Queries 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」をご参照ください。

    時間

    非対象

    照会する時点。The point in time to query. この値は、秒単位の正確なUNIXタイムスタンプです。 デフォルト値は現在の時刻です。

    タイムアウト

    非対象

    クエリのタイムアウト期間。 単位は秒です。

    タイムアウト期間は、1s、2m、3h、または4d形式で指定できます。 値1sは1秒を示し、値2mは2分を示し、値3hは3時間を示し、値4dは4日を示す。 詳細については、「期間」をご参照ください。

    lookback-デルタ

    非対象

    query.lookback-delta flagパラメーターのカスタム値を指定するために使用できる変数。 この値は、現在のクエリに対してのみ有効です。 値は期間の指定に従わなければなりません。 詳細については、「期間」をご参照ください。 この変数は、PromQLが計算中に特定の時点を識別するときの最大バックトラック範囲を指定します。 Simple Log Service MetricStoresの変数には、デフォルト値である3mが使用されます。

    範囲クエリAPI

    Range Queries 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

    NOT

    照会する期間の開始時刻です。 この値は、秒単位の正確なUNIXタイムスタンプです。

    終了

    NOT

    照会する期間の終了時刻を設定します。 この値は、秒単位の正確なUNIXタイムスタンプです。

    ステップ

    NOT

    クエリが実行される間隔。 単位は秒です。

    タイムアウト期間は、1s、2m、3h、または4d形式で指定できます。 値1sは1秒を示し、値2mは2分を示し、値3hは3時間を示し、値4dは4日を示す。 詳細については、「期間」をご参照ください。

    タイムアウト

    NOT

    クエリのタイムアウト期間。 単位は秒です。

    タイムアウト期間は、1s、2m、3h、または4d形式で指定できます。 値1sは1秒を示し、値2mは2分を示し、値3hは3時間を示し、値4dは4日を示す。 詳細については、「期間」をご参照ください。

    lookback-デルタ

    NOT

    query.lookback-delta flagパラメーターのカスタム値を指定するために使用できる変数。 この値は、現在のクエリに対してのみ有効です。 値は期間の指定に従わなければなりません。 詳細については、「期間」をご参照ください。 この変数は、PromQLが計算中に特定の時点を識別するときの最大バックトラック範囲を指定します。 Simple Log Service MetricStoresの変数には、デフォルト値である3mが使用されます。

    詳細については、「メトリッククエリのAPI操作」をご参照ください。

    メタデータクエリのAPI操作

    クエリシリーズAPI

    Query Series APIは、特定の期間内に特定の条件を満たすすべてのStoreviewsと、Storeviewsのラベルベースの数値ペアを照会するために使用されます。 

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

    下表に、各パラメーターを説明します。

    変数

    必須 / 任意

    説明

    match[]

    対象

    The filter condition. 例: up{instance="demo.*"} 。

    1つ以上の条件を指定できます。

    start

    NOT

    照会する期間の開始時刻です。 この値は、秒単位の正確なUNIXタイムスタンプです。

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

    終了

    NOT

    照会する期間の終了時刻を設定します。 この値は、秒単位の正確なUNIXタイムスタンプです。

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

    重要

    startおよびend変数の値を指定した場合、この操作を呼び出して、end変数で指定された時間の5分以内に生成されたデータのみを照会できます。

    クエリラベル名API

    [ラベル名の照会] APIは、特定の期間内に特定の条件を満たすすべてのラベル名を照会するために使用されます。 

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

    下表に、各パラメーターを説明します。

    変数

    必須 / 任意

    説明

    match[]

    対象

    The filter condition. 例: up{instance="demo.*"} 。

    1つ以上の条件を指定できます。 変数を空のままにすることもできます。

    start

    NOT

    照会する期間の開始時刻です。 この値は、秒単位の正確なUNIXタイムスタンプです。

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

    終了

    NOT

    照会する期間の終了時刻を設定します。 この値は、秒単位の正確なUNIXタイムスタンプです。

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

    重要

    startおよびend変数の値を指定した場合、この操作を呼び出して、end変数で指定された時間の5分以内に生成されたデータのみを照会できます。

    クエリラベル値API

    ラベル値の照会API操作は、特定の期間内に特定の条件を満たす特定のラベル名のすべてのラベル値を照会するために使用されます。

    重要

    Query Label Values API操作のURLの <label_name> パラメーターを、必要なラベル名に置き換えます。 

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

    下表に、各パラメーターを説明します。

    変数

    必須 / 任意

    説明

    match[]

    対象

    The filter condition. 例: up{instance="demo.*"} 。

    1つ以上の条件を指定できます。

    start

    NOT

    照会する期間の開始時刻です。 この値は、秒単位の正確なUNIXタイムスタンプです。

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

    終了

    NOT

    照会する期間の終了時刻を設定します。 この値は、秒単位の正確なUNIXタイムスタンプです。

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

    重要

    startおよびend変数に値を指定した場合、この操作を呼び出して、end変数で指定された時間の5分以内に生成されたデータのみを照会できます。

    詳細については、「メタデータクエリのAPI操作」をご参照ください。

    関連ドキュメント

    • Simple Log Serviceは、時系列データのクエリと分析の構文をサポートしています。 詳細については、「メトリックデータのクエリと分析の概要」をご参照ください。

    • Simple Log Serviceは、時系列メトリックをクエリしたり、メトリックデータをMetricStoresに書き込んだりするための複数のAPIを提供します。 詳細については、「MetricStore HTTP APIの詳細」をご参照ください。