Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
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 log
Titik akhir log mengikuti polahttps://logs.. Misalnya, untukWilayah AWS.amazonaws.com/v1/logsUS 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.
Endpoint mendukung metode otentikasi berikut:
-
AWS Signature Version 4 (SigV4) - Direkomendasikan untuk beban kerja yang sedang berjalan. AWS Menggunakan kredensi jangka pendek melalui peran IAM. Untuk informasi selengkapnya, lihat Versi AWS Tanda Tangan 4 untuk permintaan API.
-
Token pembawa (kunci API) — Untuk beban kerja yang berjalan di luar AWS atau lingkungan yang tidak mendukung SDK AWS . Memerlukan otentikasi token pembawa untuk diaktifkan pada grup log target. Untuk informasi selengkapnya, lihat Menyiapkan otentikasi token pembawa untuk Log.
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 Objek Log Besar (LLO) dan bidang sistem referensi LLO ditambahkan. Secara opsional, Anda dapat menentukan jalur bidang yang perlu dipotong dengan mengatur header HTTP. x-aws-truncatable-fields LLO dapat diambil dan dialirkan kembali menggunakan API. GetLogObject Untuk informasi selengkapnya, lihat GetLogObject. Dukungan acara log yang lebih besar dari 1MB dan pengalaman LLO tersedia di AS Timur (Virginia N) AS Barat (Oregon), Eropa (Frankfurt), Asia Pasifik (Sydney), Asia Pasifik (Mumbai), AS Timur (Ohio), Eropa (Irlandia), Asia Pasifik (Tokyo), dan Asia Pasifik (Singapura).
Titik akhir metrik
Titik akhir metrik mengikuti pola. https://monitoring. Misalnya, untuk Wilayah AS Barat (Oregon) (us-west-2), titik akhirnya adalah. AWS
Region.amazonaws.com/v1/metricshttps://monitoring.us-west-2.amazonaws.com/v1/metrics
Anda perlu mengkonfigurasi OpenTelemetry kolektor Anda untuk mulai mengirim metrik ke CloudWatch. Endpoint mendukung dua metode otentikasi:
-
AWS Signature Version 4 (SigV4) — Metode otentikasi yang disarankan menggunakan kredensi jangka pendek. Untuk informasi selengkapnya, lihat Versi AWS Tanda Tangan 4 untuk permintaan API.
-
Token pembawa (kunci API) — Untuk beban kerja yang berjalan di luar AWS atau lingkungan yang tidak mendukung SDK AWS . Menggunakan kunci API berumur panjang yang diteruskan di
Authorizationheader. Untuk informasi selengkapnya, lihat Menyiapkan otentikasi token pembawa untuk Metrik.
Jejak titik akhir
Titik akhir jejak mengikuti polahttps://xray.. Misalnya, untuk Wilayah AS Barat (Oregon) (us-west-2), titik akhirnya adalah. AWS
Region.amazonaws.com/v1/traceshttps://xray.us-west-2.amazonaws.com/v1/traces
Anda perlu mengkonfigurasi OpenTelemetry kolektor Anda untuk mulai mengirim jejak ke CloudWatch. Titik akhir mengautentikasi penelepon menggunakan otentikasi Signature 4. Untuk informasi selengkapnya, lihat Versi AWS Tanda Tangan 4 untuk permintaan API.
Titik akhir RUM
Titik akhir RUM mengikuti polahttps://dataplane.rum.{AWS
Region}.amazonaws.com/v1/rum. Misalnya, untuk Wilayah Barat AS (Oregon), titik akhirnya adalah. https://dataplane.rum.us-west-2.amazonaws.com/v1/rum Titik akhir ini menangani data telemetri sisi klien (hanya jejak dan catatan log denganeventName) untuk aplikasi RUM. CloudWatch
Untuk menggunakan endpoint ini, Anda harus membuat monitor aplikasi RUM dengan platform Mobile (Android/iOS) dan menggunakan cuplikan kode yang dihasilkan untuk instrumen aplikasi Anda. Cuplikan akan menarik SDK Seluler RUM yang dikonfigurasi dengan titik akhir ini. Anda dapat mengonfigurasi SDK lebih lanjut untuk RUM untuk mengumpulkan telemetri yang sesuai.
Titik akhir mendukung permintaan yang diautentikasi dan tidak diautentikasi. Anda dapat menggunakan AWS Signature Version 4 (SigV4) untuk permintaan yang diautentikasi, atau kebijakan berbasis sumber daya untuk mengizinkan akses yang tidak diautentikasi dari aplikasi seluler.
Untuk mempelajari lebih lanjut tentang model autentikasi sebagaimana didefinisikan dalam SDK mereka, lihat berikut ini:
-
Aplikasi iOS - AWS Distro untuk OpenTelemetry (ADOT) iOS SDK
. -
Aplikasi Android - AWS Distro untuk OpenTelemetry (ADOT) Android SDK
.
Batas dan batasan titik akhir
Tabel mencantumkan batas dan batasan titik akhir umum untuk metrik, jejak, dan log.
| Kuota | Titik akhir | Informasi tambahan |
|---|---|---|
|
Ekstensi kolektor yang diperlukan |
Untuk mengirim metrik, log, atau jejak ke titik akhir OTLP, Anda harus menggunakan sigv4authextension. Untuk titik akhir metrik dan log, Anda dapat mengautentikasi dengan token pembawa menggunakan ekstensi bearertokenauth. |
|
|
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 rentang 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 metrik.
| Kuota | Titik akhir metrik | Informasi tambahan | Kode kesalahan |
|---|---|---|---|
TPS Maksimum |
500 |
Jumlah maksimum permintaan per detik diperbolehkan per akun. |
429 |
Tingkat pembuatan seri baru maksimum |
1.000.000 |
Jumlah maksimum seri baru yang dapat dibuat dalam jendela 10 menit. Batas ini hanya berlaku untuk membuat nama metrik baru, bukan untuk menelan titik data untuk metrik yang ada. |
429 - semua metrik dalam permintaan dibatasi; 200 - metrik dalam permintaan dibatasi sebagian |
Ukuran permintaan maksimum |
1 MB |
Ukuran maksimum permintaan yang tidak terkompresi. |
400 |
Jumlah titik data maksimum |
1.000 |
Jumlah maksimum titik data yang dikirim dalam satu permintaan. Angka ini adalah jumlah di seluruh ResourceMetrics, ScopeMetrics dan Metrik. |
400 |
Ukuran metadata maksimum |
40 KB |
Ukuran gabungan maksimum dari semua label dan nilai label diterima untuk seri per titik data. |
400 - semua metrik dalam permintaan tidak valid; 200 - metrik dalam permintaan sebagian tidak valid |
Jumlah label maksimum |
150 |
Jumlah maksimum label di seluruh Resource/Scope/Datapoint atribut per titik data. |
400 - semua metrik dalam permintaan tidak valid; 200 - metrik dalam permintaan sebagian tidak valid |
Metrik membuat stempel waktu |
10 menit di masa depan dan 14 hari di masa lalu |
Metrik dapat dibuat dengan stempel waktu yang paling lama 10 menit di masa depan dan paling banyak 14 hari di masa lalu. |
400 |
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 UTF-8, ditambah 26 byte untuk setiap catatan log. |
|
20 MB Hanya tersedia di AS Timur (Virginia N) AS Barat (Oregon), Eropa (Frankfurt), Asia Pasifik (Sydney), Asia Pasifik (Mumbai), AS Timur (Ohio), Eropa (Irlandia), Asia Pasifik (Tokyo), dan Asia Pasifik (Singapura). |
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 (LLO). |
|
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), Asia Pasifik (Sydney), Asia Pasifik (Mumbai), AS Timur (Ohio), Eropa (Irlandia), Asia Pasifik (Tokyo), dan Asia Pasifik (Singapura). |
Untuk konten yang melebihi 1MB dalam peristiwa log, kelebihan konten disimpan sebagai LLO. Terbatas untuk 1 catatan log per permintaan. |
|
Objek log besar maksimum/catatan |
10 LLO Tersedia di AS Timur (Virginia N.) AS Barat (Oregon), Eropa (Frankfurt), Asia Pasifik (Sydney), Asia Pasifik (Mumbai), AS Timur (Ohio), Eropa (Irlandia), Asia Pasifik (Tokyo), dan Asia Pasifik (Singapura). |
Sebuah catatan log tunggal dapat berisi hingga 10 LLO. |
catatan
Batas akun untuk Log dibagikan di seluruh SDK dan titik akhir Log baru.
