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](CloudWatch-OTLPGettingStarted.md).
## Titik akhir log
Titik akhir log mengikuti pola`https://logs.Wilayah AWS.amazonaws.com/v1/logs`. Misalnya, untuk`US West (Oregon) (us-west-2) Region`, titik akhir akan menjadi`https://logs.us-west-2.amazonaws.com/v1/logs`. Anda dapat menggunakan titik akhir di atas untuk meneruskan log ke yang sudah ada `LogGroup` dan`LogStream`. Untuk informasi selengkapnya tentang pengaturan `LogGroup` untuk menyerap data log, lihat [konsep Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogsConcepts.html).
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](CloudWatch-OTLPGettingStarted.md). Titik akhir mengautentikasi penelepon menggunakan otentikasi Signature 4. Untuk informasi selengkapnya, lihat [Versi AWS Tanda Tangan 4 untuk permintaan API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html).
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](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogObject.html). 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.AWS Region.amazonaws.com/v1/metrics` Misalnya, untuk Wilayah AS Barat (Oregon) (us-west-2), titik akhirnya adalah. `https://monitoring.us-west-2.amazonaws.com/v1/metrics`
Anda perlu mengkonfigurasi OpenTelemetry kolektor Anda untuk mulai mengirim metrik ke CloudWatch. Titik akhir mengautentikasi penelepon menggunakan otentikasi Signature 4. Untuk informasi selengkapnya, lihat [Versi AWS Tanda Tangan 4 untuk permintaan API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html).
## Jejak titik akhir
Titik akhir jejak mengikuti pola`https://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. Titik akhir mengautentikasi penelepon menggunakan otentikasi Signature 4. Untuk informasi selengkapnya, lihat [Versi AWS Tanda Tangan 4 untuk permintaan API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html).
## Titik akhir RUM
Titik akhir RUM mengikuti pola`https://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 dengan`eventName`) untuk aplikasi RUM. CloudWatch
Untuk menggunakan endpoint ini, Anda harus membuat [monitor aplikasi RUM](CloudWatch-RUM-get-started-create-app-monitor.md) dengan platform Mobile (Android/iOS) dan menggunakan cuplikan kode yang dihasilkan untuk instrumen aplikasi Anda. Cuplikan akan menarik RUM Mobile SDKs yang dikonfigurasi dengan titik akhir ini. Anda dapat mengonfigurasi SDKs 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 otentikasi sebagaimana didefinisikan dalam model autentikasi SDKs, lihat berikut ini:
+ Aplikasi iOS - [AWS Distro untuk OpenTelemetry (ADOT) iOS SDK](https://github.com/aws-observability/aws-otel-swift).
+ Aplikasi Android - [AWS Distro untuk OpenTelemetry (ADOT) Android SDK](https://github.com/aws-observability/aws-otel-android).
## 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 | [sigv4authextension](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/extension/sigv4authextension) | Untuk mengirim metrik atau 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 metrik.
| Kuota | Titik akhir metrik | Informasi tambahan | Kode kesalahan |
| --- | --- | --- | --- |
| TPS Maksimum | 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 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 |
Tabel mencantumkan batas titik akhir dan batasan untuk log.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonCloudWatch/latest/monitoring/CloudWatch-OTLPEndpoint.html)
**catatan**
Batas akun untuk Log dibagikan di seluruh SDK dan titik akhir Log baru.