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

NDJSON エンドポイントを使用したログの送信 (ND-JSON Logs)

ND-JSON Logs エンドポイント (/ingest/bulk) は、NDJSON (Newline Delimited JSON) 形式のログを受け入れます。各行には、改行文字で区切られた 1 つの JSON 値のみが含まれます。

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

リクエストの形式

(LF) または \n (CRLF) で区切って、行ごとに 1 つの \r\n JSON 値を送信します。空の行はサイレントに無視されます。

{"timestamp":1771007942000,"message":"event one","level":"INFO"}
{"timestamp":1771007943000,"message":"event two","level":"ERROR"}
{"timestamp":1771007944000,"message":"event three","level":"DEBUG"}

application/json と の両方application/x-ndjsonが Content-Type として受け入れられます。

許容される JSON 値タイプ

NDJSON 仕様 (RFC 8259) に従って、有効な JSON 値は各行で受け入れられます。

JSON オブジェクト (最も一般的):

{"timestamp":1771007942000,"message":"User logged in","service":"auth"}
{"timestamp":1771007943000,"error":"Connection timeout","service":"api"}

JSON 配列 (個々のイベントにフラット化):

[{"timestamp":1000,"message":"a"},{"timestamp":2000,"message":"b"}]

この 1 行は 2 つのイベントを生成します。各配列要素は個別のログイベントになります。

プリミティブ値:

"a plain string log message"
42
true
null

各プリミティブは、サーバーの現在のタイムスタンプを持つ独自のイベントになります。

混合型:

{"timestamp":1771007942000,"message":"structured event"}
"unstructured string message"
42
{"timestamp":1771007943000,"error":"something failed"}

4 行はすべて有効なイベントとして受け入れられます。

タイムスタンプフィールド

"timestamp" フィールドはエポックミリ秒 (秒ではなく) です。

無効な行

有効な JSON ではない行は、サイレントにスキップされ、カウントされます。処理は次の行に進みます。

{"message":"valid event"}
this is not valid json
{"message":"another valid event"}

結果: 2 つのイベントが取り込まれ、1 つはスキップされました。戻り値HTTP 200。

すべての行が無効の場合、 は HTTP 400とともに を返します"All events were invalid"。

リクエスト例

curl -X POST "https://logs.<region>.amazonaws.com/ingest/bulk?logGroup=MyLogGroup&logStream=MyStream" \
  -H "Authorization: Bearer ACWL<token>" \
  -H "Content-Type: application/x-ndjson" \
  -d '{"timestamp":1771007942000,"message":"User logged in","level":"INFO"}
{"timestamp":1771007943000,"message":"Query took 42ms","level":"DEBUG"}
{"timestamp":1771007944000,"error":"Connection refused","level":"ERROR"}'

レスポンス

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

HTTP 200 OK
{}

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

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

rejectedLogRecords フィールドは、拒否されたイベントの総数です。errorMessage フィールドには、拒否理由別の JSON エンコードされた内訳が含まれます。

ベストプラクティス

イベントのバッチ処理

パフォーマンスと効率を向上させるには:

エラー処理

アプリケーションに適切なエラー処理を実装します。一般的な HTTP ステータスコード:

制限事項