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 HLC (Log HLC)

Titik akhir HLC Logs (/services/collector/event) didasarkan pada format HTTP Log Collector (HLC).

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

Mode masukan

Setiap peristiwa adalah objek JSON dengan "event" bidang wajib. Bidang metadata opsional:"time",,"host","source","sourcetype". "index"

Acara tunggal:

{"event":"Hello world!","time":1486683865.0}

JSON array acara:

[
  {"event":"msg1","time":1486683865.0},
  {"event":"msg2","time":1486683866.0}
]

Acara bergabung/batch (tidak ada pembungkus array):

{"event":"msg1","time":1486683865.0}{"event":"msg2","time":1486683866.0}

Bidang acara (wajib)

"event"Bidang itu wajib. Nilainya dapat berupa jenis JSON:

{"event":"a string message"}
{"event":{"message":"structured data","severity":"INFO"}}
{"event":42}
{"event":true}

Objek tanpa "event" bidang dilewati secara diam-diam:

{"message":"this is skipped — no event field"}

Bidang waktu (opsional)

"time"Bidang ini dalam detik epoch (bukan milidetik), dengan desimal opsional untuk presisi sub-detik.

Content-Type

Hanya application/json diterima.

Jenis nilai JSON yang diterima

Format titik akhir

URL titik akhir HLC mengikuti format ini:

https://logs.<region>.amazonaws.com/services/collector/event?logGroup=<name>&logStream=<name>[&entityName=<name>&entityEnvironment=<environment>]

Parameter yang diperlukan:

Parameter opsional:

Anda dapat secara opsional mengaitkan peristiwa log Anda dengan Service entitas dengan menyertakan parameter kueri berikut. Karena log yang dikirim melalui titik akhir HLC adalah telemetri khusus, mereka tidak secara otomatis terkait dengan entitas. Dengan menyediakan parameter ini, CloudWatch Log membuat entitas dengan KeyAttributes.Type set ke Service dan mengaitkannya dengan peristiwa log Anda. Ini memungkinkan fitur terkait Jelajahi CloudWatch untuk menghubungkan log ini dengan telemetri lain (metrik, jejak, dan log) dari layanan yang sama, sehingga memudahkan pemecahan masalah dan memantau aplikasi Anda di berbagai jenis sinyal. Untuk informasi selengkapnya tentang entitas dan telemetri terkait, lihat Menambahkan informasi terkait ke telemetri kustom.

Format permintaan

Kirim log menggunakan HTTP POST dengan header dan badan berikut:

Header:

Format tubuh:

Badan permintaan harus dalam format JSON dengan array peristiwa:

{
    "event": [
        {
            "time": 1730141374.001,
            "event": "Application started successfully",
            "host": "web-server-1",
            "source": "application.log",
            "severity": "info"
        },
        {
            "time": 1730141374.457,
            "event": "User login successful",
            "host": "web-server-1",
            "source": "auth.log",
            "user": "john.doe"
        }
    ]
}

Deskripsi bidang:

Bidang kustom tambahan dapat dimasukkan sesuai kebutuhan.

Contoh permintaan

curl -X POST "https://logs.<region>.amazonaws.com/services/collector/event?logGroup=MyLogGroup&logStream=MyStream" \
  -H "Authorization: Bearer ACWL<token>" \
  -H "Content-Type: application/json" \
  -d '{"event":{"message":"User logged in","user_id":"u-123"},"time":1486683865.0,"host":"web-01","source":"auth-service"}'

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