Simple Log Service を使用すると、ログをフィルターするためのクエリ文を実行できます。検索結果を単独で使用することも、より複雑な分析のために分析文への入力として使用することも可能です。
前提条件
ログをクエリするには、インデックスを作成する必要があります。
基本構文
SLS クエリスキルによるインテリジェントなログクエリと分析:SLS はエージェントスキルを提供しており、ローカル AI エージェント内で自然言語を使用して SLS ログデータをクエリおよび分析できます。
クエリ文と分析文は、| で区切られ、形式は クエリ文|分析文 です。以下の例をご参照ください。
* | SELECT status, count(*) AS PV GROUP BY status文の種類 | 説明 |
検索文 | 検索条件を指定します。条件には、キーワード、数値、数値範囲、スペース、またはアスタリスク (*) を使用できます。 スペースまたはアスタリスク (*) を指定した場合、フィルターは適用されません。 重要 検索文に指定できる条件は 30 個までです。 |
分析文 | 重要 分析文は必ず検索文と一緒に使用してください。分析文では FROM 句や WHERE 句を指定する必要はありません。サービスはデフォルトで現在の Logstore 内のすべてのデータを分析します。分析文は大文字と小文字を区別せず、オフセットをサポートせず、末尾にセミコロン (;) を付ける必要もありません。 検索結果またはすべてのデータに対して計算および統計分析を実行します。SLS は以下の分析関数および構文をサポートしています。 |
検索クエリの作成
クエリ文を作成するには、次の手順を実行します。
ステップ 1:検索タイプの選択
ステップ 2:フィールドのデータ型
ステップ 3:マッチモードの選択
検索文の例
検索文は、ログの内容およびインデックス構成に応じて異なる結果を返します。このトピックの例は、以下のサンプルログおよびインデックス構成に基づいています。
Text、double、および long 型
サンプルログ
このトピックでは、NGINX アクセスログを使用して一般的な検索文を紹介します。

インデックス構成
ログをクエリするには、事前にインデックスを作成する必要があります。インデックス構成を確認するには、次の手順を実行します。
Logstore の クエリと分析 ページで、 を選択します。

表示されたパネルで、フィールドインデックスが構成されているかどうかを確認します。

一般的な検索
あいまい検索
デリミタによる検索
キーワードのエスケープ
JSON 型
サンプルログ
{
"timestamp": "2025-03-21T14:35:18Z",
"level": "ERROR",
"service": {
"name": "payment-processor",
"version": "v2.8.1",
"environment": "production"
},
"error": {
"code": 5031,
"message": "Failed to connect to third-party API",
"details": {
"endpoint": "https://api.paymentgateway.com/v3/verify",
"attempts": 3,
"last_response": {
"status_code": 504,
"headers": {
"Content-Type": "application/json",
"X-RateLimit-Limit": "100"
}
}
}
},
"user": {
"id": "usr-9a2b3c4d",
"session": {
"id": "sess-zxy987",
"device": {
"type": "mobile",
"os": "Android 14",
"network": "4G"
}
}
},
"trace": {
"correlation_id": "corr-6f5e4d3c",
"span_id": "span-00a1b2"
}
}インデックス構成
ログをクエリするには、事前にインデックスを作成する必要があります。インデックス構成を確認するには、次の手順を実行します。
Logstore の クエリと分析 ページで、 を選択します。

表示されたパネルで、フィールドインデックスが構成されているかどうかを確認します。

例
目的 | 検索文 |
リクエストエラーを記録したログを検索します。 | |
ID が | |
ユーザー | |
よくある質問
クエリがログを返さない
JSON ログの問題
クエリエラーのトラブルシューティング
関連トピック
ログクエリの例
JSON ログのクエリ例(フィールド値が JSON オブジェクトまたは配列の場合)については、「JSON ログのクエリおよび分析」をご参照ください。