OTLP エンドポイント

OpenTelemetry Protocol (OTLP) は、OpenTelemetry 用に設計された汎用テレメトリデータ配信プロトコルです。CloudWatch OpenTelemetry エンドポイントは HTTP 1.1 エンドポイントです。オープンテレメトリデータを CloudWatch に送信し始めるように OpenTelemetry コレクターを設定する必要があります。詳細については、「入門」を参照してください。エンドポイントは、署名 4 認証を使用して発信者を認証します。詳細については、「API リクエストに対する AWS Signature Version 4」を参照してください。

トレースエンドポイント

トレースエンドポイントはパターン https://xray.AWS Region.amazonaws.com/v1/traces に従います。たとえば、米国西部 (オレゴン) (us-west-2) リージョンの場合、エンドポイントは https://xray.us-west-2.amazonaws.com/v1/traces になります。

CloudWatch へのトレースの送信を開始するには、OpenTelemetry コレクターを設定する必要があります。開始するには、「入門」を参照してください。

ログエンドポイント

ログエンドポイントはパターン https://logs.AWS リージョン.amazonaws.com/v1/logs に従います。たとえば、US West (Oregon) (us-west-2) Region の場合、エンドポイントは https://logs.us-west-2.amazonaws.com/v1/logs になります。上記のエンドポイントを使用して、既存の LogGroup および LogStream にログを転送できます。ログデータを取り込むための LogGroup の設定の詳細については、「Amazon CloudWatch Logs の概念」を参照してください。CloudWatch Logs OpenTelemetry エンドポイントを呼び出すときに、x-aws-log-group と x-aws-log-stream HTTP ヘッダーをそれぞれ LogGroup と LogStream の名前に設定して、LogGroup と LogStream を設定する必要があります。詳細については、「入門」を参照してください。

エンドポイントの制限と規制

この表は、トレースとログの一般的なエンドポイントの制限を示しています。

[制限]	エンドポイント	追加情報
必要なコレクター拡張機能	sigv4authextension	OTLP エンドポイントにトレースを送信するには、sigv4authextension を使用する必要があります
サポートされるプロトコル	HTTP	エンドポイントは HTTP のみをサポートし、gRPC はサポートしません。
サポートされる OTLP バージョン:	OTLP 1.x
ペイロード形式	バイナリ、JSON	エンドポイントは、バイナリ形式と JSON 形式を使用してリクエストを受け入れます。
圧縮方法	gzip、なし	エンドポイントは gzip のみをサポートし、圧縮メソッドはサポートしません

この表は、トレースのエンドポイントの制限の一覧です。

[制限]	トレースエンドポイント	追加情報
最大非圧縮バイト数/リクエスト	5 MB	OTLP エンドポイントは、ペイロードが非圧縮の場合、5MB を超えるリクエストを拒否します。
最大イベント/リクエスト	10,000 スパン	1 つのリクエストで許可されるスパンの最大数は 10,000 です。この制限を超えると、API コールが拒否されます。
単一のリソースとスコープのサイズ	16 KB	各一意のリソースと対応するスコープのサイズは 16 KB を超えることはできません。いずれかのリソースに対してこの制限を超えると、API コール全体が拒否されます。
単一スパンの最大サイズ	200 KB	200KB を超えるスパンはエンドポイントによって拒否されます。
スパン作成タイムスタンプ	2 時間先、過去 14 日	バッチ内のどのスパンも、2 時間以上先または 14 日以上過去にすることはできません。
イベント/リクエストにおける時間のずれの最大値	24 時間

この表は、ログのエンドポイントの制限の一覧です。

[制限]	ログエンドポイント	追加情報
最大非圧縮バイト数/リクエスト	1 MB	OTLP エンドポイントは、ペイロードが非圧縮の場合、1MB を超えるリクエストを拒否します。 最大リクエストサイズは、プロトコルバッファによってシリアル化されたバイナリデータの解凍と逆シリアル化後、1,048,576 バイトです。このサイズは、UTF-8 のすべてのイベントメッセージの合計に各ログイベントにつき 26 バイトを加算して計算されます。
1 秒あたりのリクエスト数	5000	リージョン、アカウント、1 秒あたり 5000 件のリクエスト。Service Quotas サービスを使用して、1 秒あたりのスロットリングクォータの引き上げをリクエストできます。
最大イベント/リクエスト	10,000 ログ	1 つのリクエストで許可されるスパンの最大数は 10,000 です。この制限を超えると、API コールが拒否されます。
単一のリソースとスコープのサイズ	16 KB	各一意のリソースと対応するスコープのサイズは 16 KB を超えることはできません。いずれかのリソースに対してこの制限を超えると、API コール全体が拒否されます。
単一の LogEvent サイズ	256 KB	LogEvent のサイズは、LogRecord、Scope、Resource のサイズの合計として計算されます。このクォータは変更できません。
ログ作成のタイムスタンプ	2 時間先、過去 14 日	バッチのログレコードは、時系列の順序である必要はありません。ただし、バッチのログレコードは 2 時間以上先と 14 日以上過去にすることはできません。また、どのログレコードもロググループの保持期間より前にすることはできません。
イベント/リクエストにおける時間のずれの最大値	24 時間

注記

ログのアカウント制限は、SDK と新しいログエンドポイント間で共有されます。