Titik Akhir OTLP

OpenTelemetry Protokol (OTLP) adalah protokol pengiriman data telemetri tujuan umum yang dirancang untuk. OpenTelemetry CloudWatch OpenTelemetry titik akhir adalah titik akhir HTTP 1.1. Anda perlu mengkonfigurasi OpenTelemetry kolektor Anda untuk mulai mengirim data telemetri terbuka ke. CloudWatch Untuk informasi selengkapnya, lihat Memulai. Titik akhir mengautentikasi penelepon menggunakan otentikasi Signature 4. Untuk informasi selengkapnya, lihat Versi AWS Tanda Tangan 4 untuk permintaan API.

Jejak titik akhir

Titik akhir jejak mengikuti polahttps://xray.AWS Region.amazonaws.com/v1/traces. Misalnya, untuk Wilayah AS Barat (Oregon) (us-west-2), titik akhirnya adalah. https://xray.us-west-2.amazonaws.com/v1/traces

Anda perlu mengkonfigurasi OpenTelemetry kolektor Anda untuk mulai mengirim jejak ke CloudWatch. Untuk memulai, lihat Memulai.

Titik akhir log

Titik akhir log mengikuti polahttps://logs.Wilayah AWS.amazonaws.com/v1/logs. Misalnya, untukUS West (Oregon) (us-west-2) Region, titik akhir akan menjadihttps://logs.us-west-2.amazonaws.com/v1/logs. Anda dapat menggunakan titik akhir di atas untuk meneruskan log ke yang sudah ada LogGroup danLogStream. Untuk informasi selengkapnya tentang pengaturan LogGroup untuk menyerap data log, lihat konsep Amazon CloudWatch Logs.

Anda harus mengkonfigurasi LogGroup dan LogStream ketika Anda memanggil OpenTelemetry titik akhir CloudWatch Log dengan menyetel x-aws-log-group dan header x-aws-log-stream HTTP ke LogGroup dan LogStream memberi nama masing-masing. Untuk informasi selengkapnya, lihat Memulai.

Ketika ukuran peristiwa log melebihi 1MB, CloudWatch Log secara otomatis memotong hingga 10 bidang, dimulai dengan bidang terbesar. Setiap bidang dipotong sesuai kebutuhan untuk menjaga total ukuran acara sedekat mungkin dengan 1MB. Bagian berlebih disimpan sebagai Large Log Objects (LLOs) dan bidang sistem referensi LLO ditambahkan. Secara opsional, Anda dapat menentukan jalur bidang yang perlu dipotong dengan mengatur header HTTP. x-aws-truncatable-fields LLOs Dapat diambil dan dialirkan kembali menggunakan API. GetLogObject Untuk informasi selengkapnya, lihat GetLogObject. Dukungan peristiwa log yang lebih besar dari 1MB dan pengalaman LLO tersedia di US East (Virginia N.) US West (Oregon), Eropa (Frankfurt), dan Asia Pasifik (Sydney).

Batas dan batasan titik akhir

Tabel ini mencantumkan batas titik akhir umum dan batasan untuk jejak dan log.

Kuota	Titik Akhir	Informasi tambahan
Ekstensi kolektor yang diperlukan	sigv4authextension	Untuk mengirim jejak ke titik akhir OTLP Anda harus menggunakan sigv4authextension
Protokol yang didukung	HTTP	Titik akhir hanya mendukung HTTP dan tidak mendukung gRPC
Versi OTLP yang didukung	OTLP 1.x
Format muatan	biner, json	Titik akhir menerima permintaan menggunakan format biner dan json
Metode kompresi	gzip, tidak ada	Titik akhir hanya mendukung gzip dan tidak ada metode kompresi

Tabel mencantumkan batas titik akhir dan batasan untuk jejak.

Kuota	Jejak titik akhir	Informasi tambahan
Byte/permintaan maksimum yang tidak terkompresi	5 MB	Titik akhir OTLP akan menolak permintaan yang lebih besar dari 5MB saat muatan tidak dikompresi.
Peristiwa maksimum/permintaan	10.000 bentang	Jumlah maksimum bentang dalam satu batch adalah 10.000. Melebihi batas ini akan menyebabkan penolakan panggilan API.
Sumber daya tunggal dan ukuran ruang lingkup	16 KB	Setiap sumber daya unik dan ruang lingkup yang sesuai tidak boleh melebihi ukuran 16 KB. Melebihi batas ini untuk sumber daya apa pun akan menyebabkan penolakan terhadap seluruh panggilan API.
Ukuran maksimum rentang tunggal	200 KB	Rentang lebih dari 200KB akan ditolak oleh titik akhir.
Span waktu yang dibuat Span	2 jam di future dan 14 hari di masa lalu	Tak satu pun dari rentang dalam batch bisa lebih dari dua jam di masa depan atau lebih dari 14 hari di masa lalu.
Kesenjangan waktu maksimum dalam acara/permintaan	24 jam

Tabel mencantumkan batas titik akhir dan batasan untuk log.

Kuota	Titik akhir log	Informasi tambahan
Byte/permintaan maksimum yang tidak terkompresi	1 MB	Titik akhir OTLP akan menolak permintaan yang lebih besar dari 1MB saat muatan tidak dikompresi. Ukuran permintaan maksimum adalah 1.048.576 byte setelah dekompresi dan deserialisasi data biner yang diserialkan oleh buffer Protokol. Ukuran ini dihitung sebagai jumlah dari semua pesan peristiwa di UTF-8, ditambah 26 byte untuk setiap catatan log.
	20 MB Hanya tersedia di AS Timur (Virginia N.) AS Barat (Oregon), Eropa (Frankfurt), dan Asia Pasifik (Sydney).	Ukuran permintaan maksimum adalah 20MB (20.971.520 byte) setelah muatan OTLP didekompresi dan diterjemahkan dari format JSON. Untuk log hingga 1MB — Log ini memiliki akses penuh ke semua fitur CloudWatch Log termasuk kueri dan ekor langsung. Untuk log yang lebih besar dari 1MB — Bagian berlebih diproses sebagai Objek Log Besar (LLOs).
Permintaan per detik	5000	5000 transaksi per detik per akun per Wilayah Anda dapat meminta peningkatan kuota pembatasan per detik dengan menggunakan layanan Service Quotas.
Sumber daya tunggal dan ukuran ruang lingkup	16 KB	Setiap sumber daya unik dan ruang lingkup yang sesuai tidak boleh melebihi ukuran 16 KB. Melebihi batas ini untuk sumber daya apa pun akan menyebabkan penolakan terhadap seluruh panggilan API.
LogEvent Ukuran tunggal	1 MB	LogEvent ukuran dihitung sebagai jumlah ukuran untuk masing-masing LogRecord, Lingkup dan Sumber Daya. Kuota ini tidak dapat diubah.
Log membuat stempel waktu	2 jam di future dan 14 hari	Catatan log dalam batch tidak harus dalam urutan kronologis. Namun, catatan log dalam batch tidak boleh lebih dari 2 jam di masa depan dan tidak boleh lebih dari 14 hari di masa lalu. Selain itu, tidak ada catatan log yang bisa lebih awal dari periode retensi grup log.
Kesenjangan waktu maksimum dalam acara/permintaan	24 jam
Peristiwa maksimum/permintaan	10.000 log	Jumlah maksimum peristiwa log dalam batch adalah 10.000. Melebihi batas ini akan menyebabkan penolakan panggilan API.
Objek/permintaan log besar maksimum	1 catatan log Tersedia di AS Timur (Virginia N.) AS Barat (Oregon), Eropa (Frankfurt), dan Asia Pasifik (Sydney).	Untuk konten yang melebihi 1MB dalam peristiwa log, kelebihan konten disimpan sebagai. LLOs Terbatas untuk 1 catatan log per permintaan.
Objek log besar maksimum/rekam	10 LLOs Tersedia di AS Timur (Virginia N.) AS Barat (Oregon), Eropa (Frankfurt), dan Asia Pasifik (Sydney).	Sebuah catatan log tunggal dapat berisi hingga 10 LLOs.

catatan

Batas akun untuk Log dibagikan di seluruh SDK dan titik akhir Log baru.