Tous les produits
Search
Centre de documentation

:GetLogsV2

Dernière mise à jour :Aug 07, 2026

Consulte les données de journal brutes d'un Logstore spécifié dans un projet et renvoie les journaux bruts dans une plage de temps spécifiée. Les résultats sont compressés avant la transmission.

Description de l'opération

  • Spécifiez la méthode de compression lors de l'utilisation. Différents langages de programmation implémentent différents algorithmes de compression. Pour plus de détails, consultez le paramètre de requête Accept-Encoding.

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

POST /logstores/{logstore}/logs HTTP/1.1

Paramètres de chemin

Paramètre

Type

Requis

Description

Exemple

logstore

string

Oui

Le nom du Logstore.

test-logstore

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

project

string

Oui

Le nom du projet.

ali-test-project

Accept-Encoding

string

Non

La méthode de compression pour le contenu de la réponse. Les utilisateurs du SDK n'ont pas besoin de spécifier ce paramètre car le SDK gère automatiquement la compression et la décompression.

Valeurs valides :

  • lz4 :

    lz4

  • gzip :

    gzip.

lz4

body

object

Non

La structure de la requête.

from

integer

Oui

L'heure de début de la requête. Cette heure fait référence à l'heure du journal spécifiée lors de l'écriture des données de journal.

1627268185

to

integer

Oui

L'heure de fin de la requête. Cette heure fait référence à l'heure du journal spécifiée lors de l'écriture des données de journal.

1627268185

line

integer

Non

Le nombre maximal de journaux à renvoyer. Ce paramètre n'est valide que lorsque le paramètre query est une instruction de requête (et non une instruction d'analyse). Valeur minimale : 0. Valeur maximale : 100. Valeur par défaut : 100.

100

offset

integer

Non

La ligne à partir de laquelle la requête commence. Ce paramètre n'est valide que lorsque le paramètre query est une instruction de requête (et non une instruction d'analyse). La valeur commence à 0. Valeur par défaut : 0.

0

reverse

boolean

Non

Indique si les journaux doivent être renvoyés dans l'ordre chronologique inverse des horodatages de journal, avec une précision à la minute. Ce paramètre n'est valide que lorsque le paramètre query est une instruction de requête (et non une instruction d'analyse).

false

powerSql

boolean

Non

Indique si Dedicated SQL doit être activé. Désactivé par défaut.

false

session

string

Non

Le paramètre de requête.

mode=scan

topic

string

Non

Le sujet. Valeur par défaut : chaîne vide.

""

query

string

Non

L'instruction de requête ou d'analyse. Pour plus d'informations, consultez présentation des requêtes et présentation des analyses.

status: 401 | SELECT remote_addr,COUNT(*) as pv GROUP by remote_addr ORDER by pv desc limit 5

forward

boolean

Non

Indique si la pagination doit se faire vers l'avant ou vers l'arrière pour les requêtes de type scan ou phrase.

false

highlight

boolean

Non

Indique si la mise en surbrillance doit être activée.

false

isAccurate

boolean

Non

Indique si le tri avec une précision à la nanoseconde doit être activé.

true

Éléments de réponse

Élément

Type

Description

Exemple

object

Le corps de la réponse.

meta

object

Les métadonnées de la réponse.

progress

string

Indique si les résultats de la requête sont complets. Valeurs valides :

Complete

aggQuery

string

La partie SQL après le tube (|) dans l'instruction de requête.

select *

whereQuery

string

La partie avant le tube (|) dans l'instruction de requête.

*

hasSQL

boolean

Indique si la requête est une requête SQL.

false

processedRows

integer

Le nombre de lignes traitées dans cette requête.

10000

elapsedMillisecond

integer

Le temps consommé par cette requête, en millisecondes.

5

cpuSec

number

Les heures-cœur consommées par Dedicated SQL.

0.002

cpuCores

integer

Le nombre de cœurs de processeur utilisés.

3

keys

array

Toutes les clés dans les résultats de la requête.

string

La clé.

key

terms

array<object>

Tous les termes dans l'instruction de requête.

object

Le terme.

{term=*, key=}

limited

integer

La limite du nombre de lignes. Renvoyé lorsque l'instruction SQL ne contient pas de clause LIMIT.

100

mode

integer

Le mode de requête. Valeurs valides :

0

phraseQueryInfo

object

Les informations de requête de phrase.

scanAll

boolean

Indicates whether all logs have been scanned.

true

beginOffset

integer

The start offset of the scan results after index filtering.

0

endOffset

integer

The end offset of the scan results after index filtering.

0

endTime

integer

The end time of the scan results after index filtering.

1

scanBytes

integer

La quantité de données analysées pendant le scan, en octets.

1024

highlights

array<object>

Le contenu mis en surbrillance.

object

Le contenu mis en surbrillance.

count

integer

Le nombre d'entrées de journal renvoyées dans cette requête.

1

processedBytes

integer

Le volume de journaux traités par la requête, en octets.

10000

isAccurate

boolean

Indique si le tri avec une précision à la nanoseconde doit être activé.

true

columnTypes

array

Les types de colonnes.

string

Le type.

long

telementryType

string

Le type de données observable.

None

data

array<object>

Les résultats renvoyés.

object

Les données renvoyées.

string

Les données renvoyées.

{'remote_addr': '198.51.XXX.XXX', 'pv': '1', '__source__': '', '__time__': '1649902984'}

Exemples

JSON format

{
  "meta": {
    "progress": "Complete",
    "aggQuery": "select *",
    "whereQuery": "*",
    "hasSQL": false,
    "processedRows": 10000,
    "elapsedMillisecond": 5,
    "cpuSec": 0.002,
    "cpuCores": 3,
    "keys": [
      "key"
    ],
    "terms": [
      {
        "test": "test",
        "test2": 1
      }
    ],
    "limited": 100,
    "mode": 0,
    "phraseQueryInfo": {
      "scanAll": true,
      "beginOffset": 0,
      "endOffset": 0,
      "endTime": 1
    },
    "scanBytes": 1024,
    "highlights": [
      {
        "test": "test",
        "test2": 1
      }
    ],
    "count": 1,
    "processedBytes": 10000,
    "isAccurate": true,
    "columnTypes": [
      "long"
    ],
    "telementryType": "None"
  },
  "data": [
    {
      "key": "{'remote_addr': '198.51.XXX.XXX', 'pv': '1', '__source__': '', '__time__': '1649902984'}"
    }
  ]
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.