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 Endpoint adalah endpoints HTTP 1.1. Anda perlu mengonfigurasi 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 adalahhttps://logs.us-west-2.amazonaws.com/v1/logs. Anda dapat menggunakan titik akhir di atas untuk meneruskan log ke LogGroup dan yang sudah adaLogStream. Untuk informasi selengkapnya tentang pengaturan LogGroup untuk menelan data log, lihat konsep https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogsConcepts.html Amazon CloudWatch Logs.
Anda harus mengkonfigurasi LogGroup dan LogStream ketika Anda memanggil OpenTelemetry titik akhir CloudWatch Logs dengan menyet x-aws-log-group el dan x-aws-log-stream header HTTP ke LogGroup dan LogStream nama masing-masing. Untuk informasi selengkapnya, lihat Memulai.
Titik akhir mendukung metode otentikasi berikut:
-
AWS Signature Version 4 (SIGv4) - Direkomendasikan untuk beban kerja yang berjalan. AWS Menggunakan kredenSIAL jangka pendek dengan menggunakan peran IAM. Untuk informasi selengkapnya, lihat AWS Tanda Tangan Versi 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 Men yiapkan 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 ukuran acara total 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 x-aws-truncatable-fields HTTP. LLO 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 AS Timur (Virginia Utara) 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 polahttps://monitoring.. Misalnya, untuk Wilayah AS Barat (Oregon) (us-west-2), titik akhir adalah. AWS
Region.amazonaws.com/v1/metricshttps://monitoring.us-west-2.amazonaws.com/v1/metrics
Anda perlu mengonfigurasi OpenTelemetry kolektor Anda untuk mulai mengirim metrik ke CloudWatch. Titik akhir mendukung dua metode otentikasi:
-
AWS Signature Version 4 (SIGv4) — Metode otentikasi yang direkomendasikan menggunakan kredenSIAL jangka pendek. Untuk informasi selengkapnya, lihat AWS Tanda Tangan Versi 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 akhir adalah. AWS
Region.amazonaws.com/v1/traceshttps://xray.us-west-2.amazonaws.com/v1/traces
Anda perlu mengonfigurasi OpenTelemetry kolektor Anda untuk mulai mengirim jejak ke CloudWatch. Titik akhir mengotentikasi pemanggil menggunakan otentikasi Signature 4. Untuk informasi selengkapnya, lihat AWS Tanda Tangan Versi 4 untuk permintaan API.
Titik akhir RUM
Titik akhir RUM mengikuti polahttps://dataplane.rum.{AWS
Region}.amazonaws.com/v1/rum. Misalnya, untuk Wilayah AS Barat (Oregon), titik akhir adalahhttps://dataplane.rum.us-west-2.amazonaws.com/v1/rum. Titik akhir ini menangani data telemetri sisi klien (hanya melacak dan mencatat catatan denganeventName) untuk CloudWatch aplikasi RUM.
Untuk menggunakan titik akhir ini, Anda harus membuat monitor aplikasi RUM dengan platform Seluler (Android/iOS) dan menggunakan cuplikan kode yang dihasilkan untuk instrumen aplikasi Anda. Cuplikan akan menarik RUM Mobile SDK yang dikonfigurasi dengan titik akhir ini. Anda dapat mengonfigurasi SDK lebih lanjut agar RUM mengumpulkan telemetri yang sesuai.
Titik akhir mendukung permintaan yang diautentikasi dan tidak diautentikasi. Anda dapat menggunakan Sig AWS nature 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 otentikasi seperti yang 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 titik akhir umum dan batasan untuk metrik, pelacakan, dan log.
| Kuota | Titik akhir | Informasi tambahan |
|---|---|---|
|
Diperlukan ekstensi kolektor |
Untuk mengirim metrik, log, atau jejak ke titik akhir OTLP, Anda harus menggunakan sigv4authextension. Untuk titik akhir metrik dan log, Anda dapat melakukan otentikasi dengan token pembawa menggunakan ekstensi bearertokenauth. https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/extension/bearertokenauthextension |
|
|
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 pelacakan.
| Kuota | Jejak titik akhir | Informasi tambahan |
|---|---|---|
|
Maksimum byte tidak terkompresi/permintaan |
5 MB |
Titik akhir OTLP akan menolak permintaan yang lebih besar dari 5MB ketika payload tidak dikompresi. |
|
Peristiwa maksimum /permintaan |
10.000 rentang |
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 seluruh panggilan API. |
|
Ukuran maksimum rentang tunggal |
200 KB |
Rentang lebih dari 200KB akan ditolak oleh titik akhir. |
|
Span membuat stempel waktu |
2 jam di masa depan dan 14 hari di masa lalu |
Tak satu pun dari rentang dalam batch dapat 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 |
|---|---|---|---|
Maksimum TPS |
500 |
Jumlah maksimum permintaan per detik yang diizinkan 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 sebagian dibatasi |
Ukuran permintaan maksimum |
1 MB |
Ukuran permintaan maksimum yang tidak terkompresi. |
400 |
Jumlah titik data maksimum |
1.000 |
Jumlah maksimum titik data yang dikirim dalam satu permintaan. Angka ini adalah jumlah lintas ResourceMetrics, ScopeMetrics dan Metrik. |
400 |
Ukuran metadata maksimum |
40 KB |
Ukuran gabungan maksimum dari semua label dan nilai label yang 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 lama 14 hari di masa lalu. |
400 |
Tabel mencantumkan batas titik akhir dan batasan untuk log.
| Kuota | Titik akhir log | Informasi tambahan |
|---|---|---|
|
Maksimum byte tidak terkompresi/permintaan |
1 MB |
Titik akhir OTLP akan menolak permintaan yang lebih besar dari 1MB ketika payload tidak dikompresi. Ukuran permintaan maksimum adalah 1.048.576 byte setelah dekompresi dan deserialisasi data biner diserialisasi oleh buffer Protokol. Ukuran ini dihitung sebagai jumlah semua pesan peristiwa di UTF-8, ditambah 26 byte untuk setiap catatan log. |
|
20MB Hanya tersedia di AS Timur (Virginia Utara) 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 payload OTLP didekompresi dan diterjemahkan dari format JSON. Untuk log hingga 1MB — Log ini memiliki akses penuh ke semua fitur CloudWatch Log termasuk query dan live tail. 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 pelambatan per detik dengan menggunakan layanan Kuota Layanan. |
|
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 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 masa depan 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. Juga, tidak ada catatan log yang dapat 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 satu batch adalah 10.000. Melebihi batas ini akan menyebabkan penolakan panggilan API. |
|
Objek log besar maksimum /permintaan |
1 catatan log Tersedia di AS Timur (Virginia Utara) 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/rekaman |
10 LLO Tersedia di AS Timur (Virginia Utara) AS Barat (Oregon), Eropa (Frankfurt), Asia Pasifik (Sydney), Asia Pasifik (Mumbai), AS Timur (Ohio), Eropa (Irlandia), Asia Pasifik (Tokyo), dan Asia Pasifik (Singapura). |
Satu catatan log dapat berisi hingga 10 LLO. |
catatan
Batas akun untuk Log dibagikan di seluruh SDK dan titik akhir Log baru.
