pull_logs - Pull logs by cursor | SLS CLI - Simple Log Service - Centro de documentación de Alibaba Cloud

Obtiene registros de forma iterativa desde una posición de cursor específica. Use este comando para recuperar grandes volúmenes de datos de registro.

Sintaxis de la solicitud

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>]

Parámetros de la solicitud

Parámetros específicos del comando:

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
--project_name	String	Sí	aliyun-test-project	Nombre del proyecto.
--logstore_name	String	Sí	logstore-a	Nombre del logstore.
--shard_id	Integer	Sí	0	ID del shard.
--cursor	String	Sí	MTYxNDc1MDAyNzM3MzIwNTcxNA==	Posición del cursor desde la cual comenzar a leer los registros.
--count	Integer	No	2	Número de grupos de registros (LogGroups) que se obtienen por solicitud. Un grupo de registros puede contener varias entradas. La cantidad real de entradas devueltas puede ser mayor que este valor.
--end_cursor	String	No	MTYxNDc1MDAyNzM3MzIwNTcxNg==	Posición del cursor donde se detiene la lectura de registros.
--compress	Boolean	No	true	Indica si se comprimen los registros devueltos. Valores válidos: true (predeterminado) false

Todos los comandos de SLS CLI también admiten Global parameters.

Ejemplos

Ejemplo de solicitud

Obtenga dos grupos de registros (LogGroups) desde un cursor específico con la cuenta predeterminada:

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

Ejemplo de respuesta

{
  "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=="
}

Códigos de error

Resuelva los errores mediante los siguientes códigos de error.

HttpStatusCode	ErrorCode	ErrorMessage	Descripción
404	LogStoreNotExist	Logstore does not exist.	El logstore no existe.
400	ParameterInvalid	Invalid cursor.	El cursor no es válido.
400	ParameterInvalid	ParameterCount should be in [0-1000].	Valor de count no válido. Rango válido: 0 a 1000.
400	ShardNotExist	Shard does not exist.	El shard no existe.
400	InternalServerError	Specified Server Error Message.	Error interno del servidor.

Common error codes