pull_logsコマンドを実行してログをプルする - Simple Log Service

指定したカーソルに基づいてログを照会します。 pull_logsコマンドを実行して、ログを繰り返しクエリし、結果を返すことができます。このコマンドは、大量のログをクエリするシナリオに適しています。

リクエスト構文

aliyunlog log pull_logs --project_name=<value> --logstore_name=<value> --shard_id=<value> --cursor=<value> [--count=<value>] [--end_cursor=<value>] [--compress=<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_name	String	課金されます	aliyun-test-project	プロジェクトの名前。
-- logstore_name	String	課金されます	logstore-a	ログストアの名前
-- shard_id	Integer	課金されます	0	シャードの ID。
-カーソル	String	課金されます	MTYxNDc1MDAyNzM3MzIwNTcxNA==	システムがログの読み取りを開始する開始カーソル。
-カウント	Integer	×	2	読み取りたいログの数。
-- end_cursor	String	課金されません	MTYxNDc1MDAyNzM3MzIwNTcxNg==	システムがログの読み取りを停止する終了カーソル。
-- compress	ブール値	課金されません	true	返されたログを圧縮するかどうかを指定します。有効な値： true (デフォルト) false

Simple Log Serviceコマンドラインインターフェイス (CLI) のグローバルパラメーターの詳細については、「グローバルパラメーター」をご参照ください。

例

リクエストの例

既定のアカウントを使用して、指定したカーソルから2つのログを照会します。サンプルコマンド:

aliyunlog log pull_logs --project_name="aliyun-test-project" --logstore_name="logstroe-a" --shard_id=0 --cursor="MTYxNDc1MDAyNzM3MzIwNTcxNA==" --count="2"

レスポンスの例

{
  "count": 2,
  "logs": [
    {
      "__source__": "203.0.113.10",
      "__tag__:__hostname__": "iZ3s******Z",
      "__tag__:__pack_id__": "81C4812927C6B529-15DA",
      "__tag__:__receive_time__": "1619597641",
      "__time__": 1619597638,
      "__topic__": "",
      "activity_id": "",
      "computer_name": "iZ3stckpfjj7wvZ",
      "event_id": "7036",
      "kernel_time": "0",
      "keywords": "[Classic]",
      "level": "Information",
      "log_name": "System",
      "message": "The Network Setup Service service entered the stopped state.",
      "message_error": "[]",
      "opcode": "",
      "process_id": "544",
      "processor_id": "0",
      "processor_time": "0",
      "provider_guid": "{555908d1-a6d7-4695-8e1e-26931d2012f4}",
      "record_number": "8623",
      "related_activity_id": "",
      "session_id": "0",
      "source_name": "Service Control Manager",
      "task": "",
      "thread_id": "3176",
      "type": "wineventlog",
      "user_data": "{\"xml_name\":\"\"}",
      "user_time": "0",
      "version": "0"
    },
    {
      "__source__": "203.0.113.10",
      "__tag__:__hostname__": "iZ3******vZ",
      "__tag__:__pack_id__": "81C4812927C6B529-15DB",
      "__tag__:__receive_time__": "1619598347",
      "__time__": 1619598344,
      "__topic__": "",
      "activity_id": "",
      "computer_name": "iZ3stckpfjj7wvZ",
      "event_id": "7036",
      "kernel_time": "0",
      "keywords": "[Classic]",
      "level": "Information",
      "log_name": "System",
      "message": "The Windows Update service entered the running state.",
      "message_error": "[]",
      "opcode": "",
      "process_id": "544",
      "processor_id": "0",
      "processor_time": "0",
      "provider_guid": "{555908d1-a6d7-4695-8e1e-26931d2012f4}",
      "record_number": "8624",
      "related_activity_id": "",
      "session_id": "0",
      "source_name": "Service Control Manager",
      "task": "",
      "thread_id": "6868",
      "type": "wineventlog",
      "user_data": "{\"xml_name\":\"\"}",
      "user_time": "0",
      "version": "0"
    }
  ],
  "next_cursor": "MTYxNDc1MDAyNzM3MzIwNTcxNg=="
}

エラーコード

エラーメッセージが返された場合は、関連するAPI操作のエラーコードに基づいてエラーを修正します。

HttpStatusCode	エラーコード	エラーメッセージ	説明
404	LogStoreNotExist	Logstoreは存在しません。	指定されたLogstoreは存在しません。
400	ParameterInvalid	無効なカーソル。Invalid cursor.	指定されたカーソルは無効です。
400	ParameterInvalid	ParameterCountは [0-1000] にある必要があります。	countパラメーターの値が無効です。 countパラメーターの有効な値は0 ~ 1000の範囲内です。
400	ShardNotExist	シャードは存在しません。	指定されたシャードは存在しません。
400	InternalServerError	Specified Server Error Message.	内部サーバーエラーが発生しました。

詳細については、「一般的なエラーコード」をご参照ください。