Storeview を作成してクエリする方法は? - Simple Log Service

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

前提条件

プロジェクトとメトリックストアが作成されていること。詳細については、「プロジェクトの管理」および「メトリックストアの管理」をご参照ください。

Metricstore の Storeview を作成し、メトリックストアを関連付ける

1. Metricstore の Storeview を作成する

Simple Log Service コンソールにログインします。[プロジェクト] セクションで、管理するプロジェクトをクリックします。
左側のナビゲーションウィンドウで、[Storeview] > [Metricstore の Storeview] を選択します。表示されたページで、アイコンをクリックして Metricstore の Storeview を作成します。
[Storeview の作成] パネルで、[Storeview 名] パラメーターを指定し、Storeview に関連付ける [メトリックストア] を追加して、[OK] をクリックします。
重要
- Storeview には、同じプロジェクトの Metricstore が含まれている必要があります。
- Metricstore の Storeview を使用すると、メトリックストア間のログに対して JOIN クエリと分析を実行できます。クエリと分析結果の精度を確保するために、次の項目に注意してください。
  - 同じタイムラインが重複しているメトリックストアを同じ Storeview に関連付けないことをお勧めします。
  - 大量のデータを格納する複数のメトリックストアを関連付けて計算を実行しないことをお勧めします。たとえば、メトリックストアのシャード数が 64 を超えている場合などです。

2. PromQL ステートメントを使用して Storeview をクエリする

説明

Metricstore の Storeview に複数のメトリックストアを関連付けると、複数のメトリックストアにわたるクエリと分析結果を表示できます。
Metricstore の Storeview は、SQL ステートメントと事前定義された処理をサポートしていません。検索ボックスに PromQL ステートメントを直接入力できます。バックエンドの計算エンジンは、複数のメトリックストアにわたって自動的に計算を実行します。詳細については、「PromQL」をご参照ください。

Metricstore の Storeview を Grafana に接続する

Grafana をインストールしてログインします。詳細については、「Grafana のインストール」を参照してください。左側のナビゲーションウィンドウで、[構成] > [データソース] を選択します。
[データソース] タブで、[データソースの追加] をクリックします。[Prometheus] を選択し、[選択] をクリックします。

[設定] タブで、パラメーターを構成します。次の表にパラメーターを示します。

パラメーター

パラメーター	説明
名前	ビジネス要件に基づいてデータソースの名前を指定します。例：Prometheus-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 ペアを使用することをお勧めします。詳細については、「プロジェクトに対する読み取り専用権限」をご参照ください。

[保存とテスト] をクリックします。

Storeview HTTP API

概要

Simple Log Service は、Metricstore の Storeview をクエリするために使用できる複数の API 操作を提供します。API 操作は、オープンソースの Prometheus プロトコルと互換性があります。Prometheus によって提供される API 操作と 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 操作

Instant Queries 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 構文」をご参照ください。
time	いいえ	クエリする時点。値は秒単位の精度の UNIX タイムスタンプです。デフォルト値は現在の時刻です。
timeout	いいえ	クエリのタイムアウト期間。単位：秒。タイムアウト期間は、1s、2m、3h、または 4d の形式で指定できます。値 1s は 1 秒、値 2m は 2 分、値 3h は 3 時間、値 4d は 4 日を示します。例：timeout=10s。詳細については、「Time Durations」を参照してください。
lookback_delta	いいえ	PromQL 計算中にメトリックを識別するために API 操作を呼び出すときの最大ルックバック期間。Simple Log Service メトリックストアでは、デフォルト値の 3m が使用されます。この変数を使用して、query.lookback-delta フラグパラメーターのカスタム値を指定できます。値は現在のクエリに対してのみ有効です。値は時間間隔の形式に従う必要があります。例：lookback_delta=1m。詳細については、「Time Durations」を参照してください。

Range Queries 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	いいえ	クエリする期間の開始時刻。値は秒単位の精度の UNIX タイムスタンプです。
end	いいえ	クエリする期間の終了時刻。値は秒単位の精度の UNIX タイムスタンプです。
step	いいえ	クエリを実行する間隔。単位：秒。タイムアウト期間は、1s、2m、3h、または 4d の形式で指定できます。値 1s は 1 秒、値 2m は 2 分、値 3h は 3 時間、値 4d は 4 日を示します。例：step=2m。詳細については、「Time Durations」を参照してください。
timeout	いいえ	クエリのタイムアウト期間。単位：秒。タイムアウト期間は、1s、2m、3h、または 4d の形式で指定できます。値 1s は 1 秒、値 2m は 2 分、値 3h は 3 時間、値 4d は 4 日を示します。例：timeout=10s。詳細については、「Time Durations」を参照してください。
lookback_delta	いいえ	PromQL 計算中にメトリックを識別するために API 操作を呼び出すときの最大ルックバック期間。Simple Log Service メトリックストアでは、デフォルト値の 3m が使用されます。この変数を使用して、query.lookback-delta フラグパラメーターのカスタム値を指定できます。値は現在のクエリに対してのみ有効です。値は時間間隔の形式に従う必要があります。例：lookback_delta=1m。詳細については、「Time Durations」を参照してください。

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

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

Query Series API

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

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.*"}。 1 つ以上の条件を指定できます。
start	いいえ	クエリする期間の開始時刻。値は秒単位の精度の UNIX タイムスタンプです。デフォルト値は現在の時刻の 5 分前です。
end	いいえ	クエリする期間の終了時刻。値は秒単位の精度の UNIX タイムスタンプです。デフォルト値は現在の時刻です。重要 start 変数と end 変数に値を指定した場合、この操作を呼び出して、end 変数で指定された時刻の 5 分前に生成されたデータのみをクエリできます。

Query Label Names API

Query Label Names API 操作は、特定の期間内に特定の条件を満たすすべてのラベル名をクエリするために使用されます。

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.*"}。 1 つ以上の条件を指定できます。変数を空のままにすることもできます。
start	いいえ	クエリする期間の開始時刻。値は秒単位の精度の UNIX タイムスタンプです。デフォルト値は現在の時刻の 5 分前です。
end	いいえ	クエリ対象の期間の終了時刻です。値は秒単位の精度の UNIX タイムスタンプです。デフォルト値は現在の時刻です。重要 [start] 変数と [end] 変数に値を指定した場合、この操作を呼び出して、[end] 変数で指定された時刻の 5 分前に生成されたデータのみをクエリできます。

Query Label Values API

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

重要

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

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

次の表にパラメーターを示します。

変数	必須	説明
match[]	はい	フィルター条件。例：match[]=up{instance="demo.*"}。 1 つ以上の条件を指定できます。
start	いいえ	クエリする期間の開始時刻。値は秒単位の精度の UNIX タイムスタンプです。デフォルト値は現在の時刻の 5 分前です。
end	いいえ	クエリする期間の終了時刻。値は秒単位の精度の UNIX タイムスタンプです。デフォルト値は現在の時刻です。重要 start 変数と end 変数に値を指定した場合、この操作を呼び出して、end 変数で指定された時刻の 5 分前に生成されたデータのみをクエリできます。

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

次のステップ

Metricstore の Storeview をクエリする

左側のナビゲーションウィンドウで、[Storeview] > [Metricstore の Storeview] を選択します。ここで、作成された Storeview を表示できます。

Metricstore の Storeview を変更する

Storeview リストで、目的の Storeview にポインターを移動し、 > [変更] を選択します。
[Storeview の更新] パネルで、Storeview を変更し、[OK] をクリックします。

Metricstore の Storeview を削除する

Storeview リストで、目的の Storeview にポインターを移動し、 > [削除] を選択します。

参照

Simple Log Service は、時系列データのクエリと分析の構文をサポートしています。詳細については、「メトリックデータのクエリと分析の構文」をご参照ください。
Simple Log Service は、時系列メトリックをクエリしたり、メトリックデータをメトリックストアに書き込んだりする複数の API を提供します。詳細については、「メトリックストア関連の HTTP API の詳細」をご参照ください。