Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mengirim log menggunakan titik akhir NDJSON (ND-JSON Logs)

Titik akhir ND-JSON Logs (/ingest/bulk) menerima log dalam format NDJSON (Newline Delimited JSON). Setiap baris berisi persis satu nilai JSON, dipisahkan oleh karakter baris baru.

Jika Anda menggunakan otentikasi token pembawa, selesaikan langkah-langkah penyiapan Menyiapkan otentikasi token pembawa sebelum melanjutkan.

Format permintaan

Kirim satu nilai JSON per baris, dipisahkan oleh \n (LF) atau \r\n (CRLF). Baris kosong diabaikan secara diam-diam.

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

Keduanya application/json dan application/x-ndjson diterima sebagai Content-Type.

Jenis nilai JSON yang diterima

Per spesifikasi NDJSON (RFC 8259), nilai JSON yang valid diterima pada setiap baris.

Objek JSON (paling umum):

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

Array JSON (diratakan menjadi peristiwa individual):

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

Baris tunggal ini menghasilkan 2 peristiwa. Setiap elemen array menjadi peristiwa log terpisah.

Nilai primitif:

"a plain string log message"
42
true
null

Setiap primitif menjadi acaranya sendiri dengan stempel waktu server saat ini.

Jenis campuran:

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

Semua 4 baris diterima sebagai acara yang valid.

Bidang stempel waktu

"timestamp"Bidang ini dalam milidetik epoch (bukan detik).

Baris tidak valid

Baris yang tidak valid JSON dilewati dan dihitung secara diam-diam. Pemrosesan berlanjut dengan baris berikutnya.

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

Hasil: 2 acara tertelan, 1 dilewati. PengembalianHTTP 200.

Jika semua baris tidak valid, kembali HTTP 400 dengan. "All events were invalid"

Contoh permintaan

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

Respons

Sukses (semua acara diterima):

HTTP 200 OK
{}

Keberhasilan sebagian (beberapa acara ditolak):

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

rejectedLogRecordsBidang adalah jumlah total peristiwa yang ditolak. errorMessageBidang berisi rincian yang dikodekan JSON dengan alasan penolakan:

Praktik terbaik

Acara batching

Untuk kinerja dan efisiensi yang lebih baik:

Penanganan kesalahan

Menerapkan penanganan kesalahan yang tepat dalam aplikasi Anda. Kode status HTTP umum:

Batasan