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

# Mengirim log menggunakan titik akhir OTLP (Log) OpenTelemetry
<a name="CWL_HTTP_Endpoints_OTLP"></a>

Endpoint Logs (`/v1/logs`) menerima data OpenTelemetry log OpenTelemetry Protocol (OTLP) baik dalam pengkodean JSON atau Protobuf. Untuk informasi rinci tentang titik akhir OTLP, termasuk konfigurasi dan penggunaan, lihat [Mengirim metrik dan](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-OTLPEndpoint.html) jejak ke with. CloudWatch OpenTelemetry

Jika Anda menggunakan otentikasi token pembawa, selesaikan langkah-langkah penyiapan [Menyiapkan otentikasi token pembawa](CWL_HTTP_Endpoints_BearerTokenAuth.md) sebelum melanjutkan.

## Format permintaan
<a name="CWL_OTLP_Format"></a>
+ Metode: `POST`
+ Tipe Konten: atau `application/json` `application/x-protobuf`
+ Grup log: hanya `x-aws-log-group` header (parameter kueri tidak didukung)
+ Aliran log: `x-aws-log-stream` header

## Contoh permintaan
<a name="CWL_OTLP_Example"></a>

```
curl -X POST "https://logs.<region>.amazonaws.com/v1/logs" \
  -H "Authorization: Bearer ACWL<token>" \
  -H "Content-Type: application/json" \
  -H "x-aws-log-group: MyLogGroup" \
  -H "x-aws-log-stream: MyLogStream" \
  -d '{
  "resourceLogs": [
    {
      "resource": {
        "attributes": [
          {
            "key": "service.name",
            "value": { "stringValue": "my-service" }
          }
        ]
      },
      "scopeLogs": [
        {
          "scope": {
            "name": "my-library",
            "version": "1.0.0"
          },
          "logRecords": [
            {
              "timeUnixNano": "1741900000000000000",
              "severityNumber": 9,
              "severityText": "INFO",
              "body": {
                "stringValue": "User logged in successfully"
              },
              "attributes": [
                {
                  "key": "user.id",
                  "value": { "stringValue": "12345" }
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}'
```

## Respons
<a name="CWL_OTLP_Responses"></a>

**Sukses (semua acara diterima):**

```
HTTP 200 OK
{}
```

**Keberhasilan sebagian (beberapa acara ditolak):**

```
{
  "partialSuccess": {
    "rejectedLogRecords": 5,
    "errorMessage": "{\"tooOldLogEventCount\": 3, \"tooNewLogEventCount\": 1, \"expiredLogEventCount\": 1}"
  }
}
```

Ketika permintaan Content-Type adalah`application/x-protobuf`, respon dikembalikan sebagai pesan `ExportLogsServiceResponse` protobuf serial dengan bidang yang sama.

## Perilaku khusus OTLP
<a name="CWL_OTLP_Specific_Behaviors"></a>

Perilaku berikut khusus untuk titik akhir OTLP dan tidak ada pada titik akhir konsumsi HTTP lainnya:
+ **Retry-After header** - Termasuk pada 503 dan 429 tanggapan untuk menunjukkan kapan klien harus mencoba lagi.