翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# OTLP エンドポイントを使用したログの送信 (OpenTelemetry Logs)
<a name="CWL_HTTP_Endpoints_OTLP"></a>

OpenTelemetry Logs エンドポイント (`/v1/logs`) は、OpenTelemetry Protocol (OTLP) ログデータを JSON エンコードまたは Protobuf エンコードで受け入れます。設定や使用状況など、OTLP エンドポイントの詳細については、[OpenTelemetry を使用して CloudWatch にメトリクスとトレースを送信する](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-OTLPEndpoint.html)」を参照してください。

ベアラートークン認証を使用している場合は、続行する[ベアラートークン認証の設定](CWL_HTTP_Endpoints_BearerTokenAuth.md)前に のセットアップステップを完了してください。

## リクエストの形式
<a name="CWL_OTLP_Format"></a>
+ 方法: `POST`
+ Content-Type: `application/json`または `application/x-protobuf`
+ ロググループ: `x-aws-log-group`ヘッダーのみ (クエリパラメータはサポートされていません)
+ ログストリーム: `x-aws-log-stream`ヘッダー

## リクエスト例
<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" }
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}'
```

## レスポンス
<a name="CWL_OTLP_Responses"></a>

**Success (すべてのイベントが受け入れられる):**

```
HTTP 200 OK
{}
```

**部分的な成功 (一部のイベントが拒否):**

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

リクエスト Content-Type が の場合`application/x-protobuf`、レスポンスは同じフィールドを持つシリアル化された `ExportLogsServiceResponse` protobuf メッセージとして返されます。

## OTLP 固有の動作
<a name="CWL_OTLP_Specific_Behaviors"></a>

以下の動作は OTLP エンドポイントに固有であり、他の HTTP 取り込みエンドポイントには存在しません。
+ **Retry-After ヘッダー** – クライアントが再試行するタイミングを示す 503 および 429 レスポンスに含まれます。