PullLogs - Simple Log Service - Centro de documentación de Alibaba Cloud

Obtiene datos de registro en una posición de cursor especificada mediante la llamada a la operación PullLogs. Esta operación obtiene registros sin procesar. Para consultar o analizar registros, use la operación GetLogsV2.

Descripción de la operación

Aviso El SDK de OpenAPI no admite esta operación. Use el SDK de Simple Log Service en su lugar.

Debe especificar un shard al obtener registros.
Solo se admiten datos en formato Protocol Buffer.
El Host en la sintaxis de la solicitud consta del nombre del proyecto y del endpoint de Simple Log Service. Especifique el proyecto en el Host.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

No se requiere autorización para esta operación. Si experimenta problemas al ejecutarla, póngase en contacto con el soporte técnico.

Sintaxis de la solicitud

GET /logstores/{logStore}/shards/{shardId}?type=log HTTP/1.1

Parámetros de ruta

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
logStore	string	Sí	El nombre del Logstore.	ali-test-logstore
shardId	integer	Sí	El ID del shard en el Logstore.	1

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
project	string	Sí	El nombre del proyecto.	ali-test-project
cursor	string	Sí	El cursor que indica la posición inicial desde la cual leer los datos.	MTQ0NzMyOTQwMTEwMjEzMDkwNA
count	integer	Sí	El número máximo de grupos de registros que se devuelven. Valor mínimo: 1. Valor máximo: 1,000.	1000
end_cursor	string	No	El cursor final que indica la posición en la que se debe detener la lectura de datos. Los datos en esa posición no se incluyen.	MTU1NzA1NzQwMTEwMjEzMDkwCg
query	string	No	La instrucción de filtro en sintaxis SPL. Para obtener más información, consulte Instrucciones de SPL.	* \| where userId='123'
Accept-Encoding	string	No	El formato de compresión esperado de los datos que devuelve el servidor. Se admite el valor lz4.	lz4

Los siguientes encabezados de solicitud son específicos de la operación PullLogs:

Accept: application/x-protobuf
Accept-Encoding: lz4

El valor de Accept-Encoding puede ser lz4, deflate o comillas dobles ("").

Ejemplo de solicitud:

GET /logstores/sls-test-logstore/shards/0?type=logs&cursor=MTQ0NzMyOTQwMTEwMjEzMDkwNA&count=1000 HTTP/1.1
Host:ali-test-project.cn-hangzhou.log.aliyuncs.com
Content-Type:application/json

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	LogGroupList	Los datos comprimidos de Protocol Buffer.

Los siguientes elementos de respuesta son específicos de la operación PullLogs:

x-log-cursor: El cursor de la siguiente entrada después de la lectura actual de datos.
x-log-end-of-cursor: El cursor de la última entrada de la lectura actual de datos.
x-log-count: El número de entradas devueltas.

Para obtener información sobre los encabezados de respuesta comunes de la API de Simple Log Service, consulte Encabezados de respuesta comunes.

Los elementos de respuesta son datos serializados en formato Protocol Buffer, que pueden estar comprimidos.

Ejemplos

Respuesta exitosa

JSON Formato

{
  "logGroupList": [
    {
      "LogItems": [
        {
          "Contents": [
            {
              "Key": "key-test",
              "Value": "value-test"
            }
          ],
          "Time": 1690254376,
          "TimeNs": 123456789
        }
      ],
      "LogTags": [
        {
          "Key": "key-test",
          "Value": "value-test"
        }
      ],
      "Source": "192.1.1.1",
      "Topic": "topic-test"
    }
  ]
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.