コマンドラインインターフェイス (CLI) を使用してログをクエリできます。このコマンドは、大量のログデータを取得する場合に最適です。
リクエスト構文
aliyunlog log get_log_all --project=<value> --logstore=<value> --from_time=<value> --to_time=<value> [--topic=<value>] [--query=<value>] [--reverse=<value>] [--offset=<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>]リクエストパラメーター
次の表に、このコマンドに固有の必須パラメーターを示します。
パラメーター名 | データ型 | 必須 | 例 | 説明 |
--project | 文字列 | はい | aliyun-test-project | プロジェクトの名前。 |
--logstore | 文字列 | はい | logstore-a | Logstore の名前。 |
--from_time | 文字列 | はい | 2025-06-01 00:00:00+8:00 | クエリ対象の時間範囲の開始時刻。UNIX タイムスタンプ、または |
--to_time | 文字列 | はい | 2025-06-01 01:00:00+8:00 | クエリ対象の時間範囲の終了時刻。UNIX タイムスタンプ、または |
--topic | 文字列 | いいえ | "" | ログのトピック。詳細については、「トピック」をご参照ください。 |
--query | 文字列 | いいえ |
| クエリと分析文。詳細については、「Query overview」および「Query and analysis overview」をご参照ください。 説明 query パラメーターに分析文 (SQL ステートメント) が含まれる場合は、line パラメーターと offset パラメーターを 0 に設定し、ページングには LIMIT 句を使用してください。詳細については、「Paginate query and analysis results」をご参照ください。 |
--reverse | ブール値 | いいえ | true | ログのタイムスタンプに基づいて、ログを逆時系列順に返すかどうかを指定します。タイムスタンプは分単位の精度です。
|
--offset | 整数 | いいえ | 0 | クエリ結果の読み取りを開始する行。デフォルト値:0。 |
このコマンドのグローバルパラメーターの詳細については、「Global parameters」をご参照ください。
例
リクエスト例
デフォルトアカウントを使用して、リクエストメソッドが POST のイベント数をクエリします。サンプルコマンドは次のとおりです。
aliyunlog log get_log_all --project="aliyun-test-project" --logstore="logstore-a" --from_time="2025-06-01 00:00:00+8:00" --to_time="2025-06-01 01:00:00+8:00" --query="request_method:POST|select status,COUNT(*) as pv group by status" --format-output=json説明from_time と to_time を、お使いの Logstore でログデータが含まれる時間範囲に置き換えてください。データが存在しない時間範囲をクエリした場合、結果は空になります。
レスポンス例
{ "data": [], "meta": { "aggQuery": "select status,COUNT(*) as pv group by status", "columnTypes": [ "long", "long" ], "count": 0, "cpuCores": 11, "cpuSec": 0.019, "elapsedMillisecond": 21, "hasSQL": true, "insertedSQL": "1,29, from \"logstore-a\" ", "isAccurate": true, "keys": [ "status", "pv" ], "limited": 100, "powerSql": false, "processedBytes": 0, "processedRows": 0, "progress": "Complete", "telementryType": "logging", "telemetryType": "logging", "terms": [ { "key": "", "term": "request_method\uff1apost" } ], "whereQuery": "request_method\uff1aPOST" } }ダウンロード例
get_log_all コマンドを使用して、ログをローカルファイルにダウンロードします。サンプルコマンドは次のとおりです。
aliyunlog log get_log_all --project="aliyun-test-project" --logstore="logstore-a" --from_time="2025-06-01 00:00:00+8:00" --to_time="2025-06-01 01:00:00+8:00" --query="status:200|select request_method as method,COUNT(*) as pv group by method order by pv" --format-output=json >>download_data.txtダウンロードの説明
コマンドが正常に実行されると、コマンドを実行したディレクトリに download_data.txt という名前のファイルが作成されます。このファイルでログ情報を確認できます。
{ "data": [], "meta": { "aggQuery": "select status,COUNT(*) as pv group by status", "columnTypes": [ "long", "long" ], "count": 0, "cpuSec": 0.019, "elapsedMillisecond": 0, "hasSQL": true, "insertedSQL": "1,29, from \"logstore-a\" ", "isAccurate": true, "keys": [ "status", "pv" ], "limited": 100, "processedBytes": 0, "processedRows": 0, "progress": "Complete", "telementryType": "logging", "telemetryType": "logging", "terms": [ { "key": "", "term": "request_method\uff1apost" } ], "whereQuery": "request_method\uff1aPOST" } }
関連情報
コマンド | シナリオ |
JSON 設定ファイルを使用して、ログデータに対してタームクエリを実行します。 | |
指定した数のログをクエリします。 |