Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Senden von Protokollen mithilfe des NDJSON-Endpunkts (ND-JSON-Protokolle)

Der Endpunkt ND-JSON Logs (/ingest/bulk) akzeptiert Protokolle im NDJSON-Format (Newline Delimited JSON). Jede Zeile enthält genau einen JSON-Wert, getrennt durch Zeilenumbruchzeichen.

Wenn Sie die Bearer-Token-Authentifizierung verwenden, schließen Sie die Einrichtungsschritte unter ab, Einrichtung der Bearer-Token-Authentifizierung bevor Sie fortfahren.

Anforderungsformat

Senden Sie einen JSON-Wert pro Zeile, getrennt durch \n (LF) oder \r\n (CRLF). Leere Zeilen werden stillschweigend ignoriert.

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

application/jsonSowohl als auch application/x-ndjson werden als Content-Type akzeptiert.

Akzeptierte JSON-Werttypen

Gemäß der NDJSON-Spezifikation (RFC 8259) wird jeder gültige JSON-Wert in jeder Zeile akzeptiert.

JSON-Objekte (am häufigsten):

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

JSON-Arrays (auf einzelne Ereignisse reduziert):

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

Diese einzelne Zeile erzeugt 2 Ereignisse. Jedes Array-Element wird zu einem separaten Protokollereignis.

Primitive Werte:

"a plain string log message"
42
true
null

Jedes Primitiv wird zu einem eigenen Ereignis mit dem aktuellen Zeitstempel des Servers.

Gemischte Typen:

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

Alle 4 Zeilen werden als gültige Ereignisse akzeptiert.

Zeitstempel-Feld

Das "timestamp" Feld ist in Epochen-Millisekunden (nicht Sekunden) angegeben.

Ungültige Zeilen

Zeilen, die kein gültiges JSON-Format sind, werden automatisch übersprungen und gezählt. Die Verarbeitung wird mit der nächsten Zeile fortgesetzt.

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

Ergebnis: 2 Ereignisse wurden aufgenommen, 1 wurde übersprungen. Gibt HTTP 200 zurück.

Wenn alle Zeilen ungültig sind, wird mit zurückgegebenHTTP 400. "All events were invalid"

Beispielanforderung

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"}'

Antworten

Erfolgreich (alle Ereignisse wurden akzeptiert):

HTTP 200 OK
{}

Teilweise erfolgreich (einige Ereignisse wurden abgelehnt):

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

Das rejectedLogRecords Feld gibt die Gesamtzahl der abgelehnten Ereignisse an. Das errorMessage Feld enthält eine JSON-kodierte Aufschlüsselung nach Ablehnungsgründen:

Best Practices

Ereignisse werden gebündelt

Für mehr Leistung und Effizienz:

Fehlerbehandlung

Implementieren Sie die richtige Fehlerbehandlung in Ihrer Anwendung. Allgemeine HTTP-Statuscodes:

Einschränkungen