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

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 jejak ke with. CloudWatch OpenTelemetry

Jika Anda menggunakan otentikasi token pembawa, selesaikan langkah-langkah penyiapan Menyiapkan otentikasi token pembawa sebelum melanjutkan.

Format permintaan

Contoh permintaan

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

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 adalahapplication/x-protobuf, respon dikembalikan sebagai pesan ExportLogsServiceResponse protobuf serial dengan bidang yang sama.

Perilaku khusus OTLP

Perilaku berikut khusus untuk titik akhir OTLP dan tidak ada pada titik akhir konsumsi HTTP lainnya: