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 JSON structuré (journaux JSON structurés)

Le point de terminaison Structured JSON Logs (/ingest/json) accepte le JSON standard, qu'il s'agisse d'un seul objet JSON ou d'un tableau d'objets JSON. Ce point de terminaison est conçu pour les données de journal structurées où chaque événement est un objet JSON.

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

Seul application/json est accepté comme type de contenu.

Objet JSON unique :

{"timestamp":1771007942000,"message":"single event","level":"INFO"}

Tableau d'objets JSON :

[
  {"timestamp":1771007942000,"message":"event one","level":"INFO"},
  {"timestamp":1771007943000,"message":"event two","level":"ERROR"}
]

Types de valeurs JSON acceptés

Ce point de terminaison est strict : seuls les objets JSON sont acceptés en tant qu'événements.

Exemple — tableau de types mixtes :

[
  {"timestamp":1771007942000,"message":"valid object"},
  "just a string",
  42,
  {"timestamp":1771007943000,"message":"another valid object"}
]

Résultat : 2 événements ingérés (les objets), 2 ignorés (la chaîne et le chiffre).

Champ d'horodatage

Le "timestamp" champ est exprimé en millisecondes d'époque, comme le point de terminaison NDJSON.

Exemple de demande

curl -X POST "https://logs.<region>.amazonaws.com/ingest/json?logGroup=MyLogGroup&logStream=MyStream" \
  -H "Authorization: Bearer ACWL<token>" \
  -H "Content-Type: application/json" \
  -d '[{"timestamp":1771007942000,"message":"User logged in","user_id":"u-123"},{"timestamp":1771007943000,"message":"Order placed","order_id":"o-456"}]'

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

Implémentez une gestion appropriée des erreurs dans votre application. Codes d'état HTTP courants :

Limitations