Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Envoi de journaux à l'aide du point de terminaison NDJSON (journaux ND-JSON)

Le point de terminaison ND-JSON Logs (/ingest/bulk) accepte les journaux au format NDJSON (Newline Delimited JSON). Chaque ligne contient exactement une valeur JSON, séparée par des caractères de nouvelle ligne.

Si vous utilisez l'authentification par jeton porteur, suivez les étapes de configuration décrites Configuration de l'authentification par jeton porteur avant de continuer.

Format des demandes

Envoyez une valeur JSON par ligne, séparée par \n (LF) ou \r\n (CRLF). Les lignes vides sont ignorées en silence.

{"timestamp":1771007942000,"message":"event one","level":"INFO"}
{"timestamp":1771007943000,"message":"event two","level":"ERROR"}
{"timestamp":1771007944000,"message":"event three","level":"DEBUG"}

Les deux application/json application/x-ndjson sont acceptés en tant que type de contenu.

Types de valeurs JSON acceptés

Selon la spécification NDJSON (RFC 8259), toute valeur JSON valide est acceptée sur chaque ligne.

Objets JSON (les plus courants) :

{"timestamp":1771007942000,"message":"User logged in","service":"auth"}
{"timestamp":1771007943000,"error":"Connection timeout","service":"api"}

Tableaux JSON (aplatis en événements individuels) :

[{"timestamp":1000,"message":"a"},{"timestamp":2000,"message":"b"}]

Cette seule ligne produit 2 événements. Chaque élément du tableau devient un événement de journal distinct.

Valeurs primitives :

"a plain string log message"
42
true
null

Chaque primitive devient son propre événement avec l'horodatage actuel du serveur.

Types mixtes :

{"timestamp":1771007942000,"message":"structured event"}
"unstructured string message"
42
{"timestamp":1771007943000,"error":"something failed"}

Les 4 lignes sont acceptées comme des événements valides.

Champ d'horodatage

Le "timestamp" champ est exprimé en millisecondes d'époque (et non en secondes).

Lignes non valides

Les lignes qui ne sont pas des JSON valides sont ignorées et comptées en silence. Le traitement se poursuit avec la ligne suivante.

{"message":"valid event"}
this is not valid json
{"message":"another valid event"}

Résultat : 2 événements ingérés, 1 ignoré. Renvoie HTTP 200.

Si toutes les lignes ne sont pas valides, renvoie HTTP 400 avec"All events were invalid".

Exemple de demande

curl -X POST "https://logs.<region>.amazonaws.com/ingest/bulk?logGroup=MyLogGroup&logStream=MyStream" \
  -H "Authorization: Bearer ACWL<token>" \
  -H "Content-Type: application/x-ndjson" \
  -d '{"timestamp":1771007942000,"message":"User logged in","level":"INFO"}
{"timestamp":1771007943000,"message":"Query took 42ms","level":"DEBUG"}
{"timestamp":1771007944000,"error":"Connection refused","level":"ERROR"}'

Réponses

Succès (tous les événements sont acceptés) :

HTTP 200 OK
{}

Succès partiel (certains événements rejetés) :

{
  "partialSuccess": {
    "rejectedLogRecords": 5,
    "errorMessage": "{\"tooOldLogEventCount\": 3, \"tooNewLogEventCount\": 1, \"expiredLogEventCount\": 1}"
  }
}

Le rejectedLogRecords champ indique le nombre total d'événements rejetés. Le errorMessage champ contient une ventilation codée en JSON par motif de rejet :

Bonnes pratiques

Événements de mise en lots

Pour de meilleures performances et une meilleure efficacité :

Gestion des erreurs

Mettez en œuvre une gestion appropriée des erreurs dans votre application. Codes d'état HTTP courants :

Limitations