Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Titik Akhir OTLP
<a name="CloudWatch-OTLPEndpoint"></a>

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
<a name="CloudWatch-LogsEndpoint"></a>

Titik akhir log mengikuti pola`https://logs.{{AWS Region}}.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
<a name="CloudWatch-MetricsEndpoint"></a>

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
<a name="CloudWatch-TracesEndpoint"></a>

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
<a name="CloudWatch-RUMEndpoint"></a>

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
<a name="CloudWatch-LimitsandRestrictions"></a>

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.



- ** Byte/permintaan maksimum yang tidak terkompresi**
  - **Titik akhir log:** 1 MB / **Informasi tambahan:** Titik akhir OTLP akan menolak permintaan yang lebih besar dari 1MB saat muatan tidak dikompresi.<br />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.
  - **Titik akhir log:** 20 MB<br />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). / **Informasi tambahan:** Ukuran permintaan maksimum adalah 20MB (20.971.520 byte) setelah muatan OTLP didekompresi dan diterjemahkan dari format JSON.<br />Untuk log hingga 1MB — Log ini memiliki akses penuh ke semua fitur CloudWatch Log termasuk kueri dan ekor langsung.<br />Untuk log yang lebih besar dari 1MB — Bagian berlebih diproses sebagai Objek Log Besar (LLOs).

- **Permintaan per detik**
  - **Titik akhir log:** 5000
  - **Informasi tambahan:** 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**
  - **Titik akhir log:** 16 KB
  - **Informasi tambahan:** 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 **
  - **Titik akhir log:** 1 MB
  - **Informasi tambahan:** LogEvent ukuran dihitung sebagai jumlah ukuran untuk masing-masing LogRecord, Lingkup dan Sumber Daya. Kuota ini tidak dapat diubah.

- **Log membuat stempel waktu**
  - **Titik akhir log:** 2 jam di future dan 14 hari
  - **Informasi tambahan:** 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**
  - **Titik akhir log:** 24 jam
  - **Informasi tambahan:**  

- ** Peristiwa maksimum/permintaan**
  - **Titik akhir log:** 10.000 log
  - **Informasi tambahan:** Jumlah maksimum peristiwa log dalam batch adalah 10.000. Melebihi batas ini akan menyebabkan penolakan panggilan API.

- ** Objek/permintaan log besar maksimum**
  - **Titik akhir log:** 1 catatan log<br />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).
  - **Informasi tambahan:** 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**
  - **Titik akhir log:** 10 LLOs<br />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).
  - **Informasi tambahan:** Sebuah catatan log tunggal dapat berisi hingga 10 LLOs.



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