指定されたプロジェクトの指定されたLogstore内のログを照会します。 このコマンドは、完全一致モードでログをクエリするシナリオに適しています。 このコマンドを使用する場合は、JSON形式の設定ファイルを準備する必要があります。 これにより、ファイルを使用してクエリ要求を柔軟かつ正確に設定できます。
コマンド構文
aliyunlog log get_logs --request=<value> [--access-id=<value>] [--access-key=<value>] [--sts-token=<value>] [--region-endpoint=<value>] [--client-name=<value>] [--jmes-filter=<value>] [--format-output=<value>] [--decode-output=<value>]
コマンドパラメーター
このコマンドに必要なパラメーターと、このコマンドに固有のパラメーターを次の表に示します。
パラメーター | データ型 | 必須 | 例 | 説明 |
-- request | JSON Object | 課金されます | ファイル: //./getlogs.json | 設定ファイルへのパス。 設定ファイルには、ログのクエリに使用されるパラメーターが含まれています。 コマンドを実行する前に、構成ファイルを作成する必要があります。 設定ファイルでは、プロジェクト、Logstore、時間範囲、およびクエリステートメントを指定する必要があります。 |
このコマンドのグローバルパラメーターの詳細については、「グローバルパラメーター」をご参照ください。
例
Logstore-aという名前のlogstoreの上位3つのステータスコードの分布を照会します。 手順:
getlogs.jsonという名前のファイルを作成します。 コンテンツの例:
{ "topic": "", "logstore": "logstore-a", "project": "aliyun-test-project", "toTime": "2021-05-28 15:33:00", "offset": "0", "query": "*|select status,COUNT(*) as pv group by status order by pv desc limit 3", "line": "2", "fromTime": "2021-05-28 15:18:00", "reverse": "true" }
クエリパラメーターには、Simple Log Serviceコンソールでデータのクエリに使用できる有効な検索ステートメントまたはクエリステートメントを指定することをお勧めします。 詳細については、「ログ検索の概要」および「ログ分析の概要」をご参照ください。
デフォルトのアカウントを使用してログを照会します。 コマンドの例:
aliyunlog log get_logs --request="file://./getlogs.json" --format-output=json
次の応答が返されます。
{ "data": [ { "__source__": "", "__time__": "1719382500", "pv": "17", "status": "200" }, { "__source__": "", "__time__": "1719382500", "pv": "3", "status": "500" } ], "meta": { "aggQuery": "select status,COUNT(*) as pv group by status order by pv desc limit 20", "columnTypes": [ "long", "long" ], "count": 2, "cpuCores": 11, "cpuSec": 0.024, "elapsedMillisecond": 38, "hasSQL": true, "insertedSQL": "1,29, from \"logstore-a\" ", "isAccurate": true, "keys": [ "status", "pv" ], "powerSql": false, "processedBytes": 226, "processedRows": 20, "progress": "Complete", "telementryType": "logging", "telemetryType": "logging", "terms": [ { "key": "", "term": "*" } ], "whereQuery": "*" } }
クエリと分析の結果には、上位3つのステータスと、各ステータスのページビュー数が表示されます。
関連ドキュメント
Simple Log Service CLIには、ログのクエリに使用できる次のコマンドが用意されています。 シナリオに基づいてコマンドを選択できます。
コマンド
シナリオ
指定した数のログを照会します。
多数のログを照会します。
APIを呼び出した後、Log Serviceによって返された応答にエラー情報が含まれている場合、呼び出しは失敗します。 API呼び出しが失敗したときに返されるエラーコードに基づいてエラーを処理できます。 詳細については、エラーコードをご参照ください。
Alibaba Cloud OpenAPI Explorerは、デバッグ機能、SDK、サンプル、および関連ドキュメントを提供します。 OpenAPI Explorerを使用して、リクエストを手動でカプセル化したり署名したりすることなく、Log Service API操作をデバッグできます。 詳細については、をご覧ください。 OpenAPIポータル。
このコマンドに対応するAPI操作の詳細については、「GetLogs」をご参照ください。
Simple Log Serviceは、Simple Log Service SDK for JavaおよびSimple Log Service SDK for Pythonを使用してGetLogs APIを呼び出す方法の例を提供します。 詳細については、「GetLogsを使用してログを照会する」および「GetLogsを使用してログを照会する」をご参照ください。