PullLogs - - Centre de documentation Alibaba Cloud

Obtient les données de journal à une position de curseur spécifiée en appelant l'opération PullLogs. Cette opération récupère les journaux bruts. Pour interroger ou analyser des journaux, utilisez l'opération GetLogsV2.

Description de l'opération

Avertissement Le SDK OpenAPI ne prend pas en charge cette opération. Utilisez plutôt le SDK Simple Log Service.

Vous devez spécifier un fragment lors de la récupération des journaux.
Seules les données au format Protocol Buffer sont prises en charge.
Le champ Host dans la syntaxe de la requête se compose du nom du projet et du point de terminaison Simple Log Service. Spécifiez le projet dans le champ Host.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Aucune autorisation n'est requise pour cette opération. En cas de problème, contactez le support technique.

Syntaxe de la requête

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

Paramètres de chemin

Paramètre	Type	Requis	Description	Exemple
logStore	string	Oui	Le nom du Logstore.	ali-test-logstore
shardId	integer	Oui	L'identifiant du fragment dans le Logstore.	1

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
project	string	Oui	Le nom du projet.	ali-test-project
cursor	string	Oui	Le curseur qui indique la position de départ à partir de laquelle lire les données.	MTQ0NzMyOTQwMTEwMjEzMDkwNA
count	integer	Oui	Le nombre maximal de groupes de journaux à renvoyer. Valeur minimale : 1. Valeur maximale : 1000.	1000
end_cursor	string	Non	Le curseur de fin qui indique la position à laquelle arrêter la lecture des données. Les données à cette position ne sont pas incluses.	MTU1NzA1NzQwMTEwMjEzMDkwCg
query	string	Non	L'instruction de filtrage en syntaxe SPL. Pour plus d'informations, consultez les instructions SPL.	* \| where userId='123'
Accept-Encoding	string	Non	Le format de compression attendu des données renvoyées par le serveur. La valeur lz4 est prise en charge.	lz4

Les en-têtes de requête suivants sont spécifiques à l'opération PullLogs :

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

La valeur Accept-Encoding peut être lz4, deflate ou des guillemets doubles ("").

Exemple de requête :

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

Éléments de réponse

Élément	Type	Description	Exemple
	LogGroupList	Les données Protocol Buffer compressées.

Les éléments de réponse suivants sont spécifiques à l'opération PullLogs :

x-log-cursor : le curseur pour l'entrée suivante après la lecture des données actuelles.
x-log-end-of-cursor : le curseur pour la dernière entrée de la lecture des données actuelles.
x-log-count : le nombre d'entrées renvoyées.

Pour plus d'informations sur les en-têtes de réponse courants de l'API Simple Log Service, consultez En-têtes de réponse courants.

Les éléments de réponse sont des données sérialisées au format Protocol Buffer, qui peuvent être compressées.

Exemples

JSON format

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

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.