本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用 NDJSON 端点发送日志（ND-JSON 日志）

ND-JSON 日志端点 (/ingest/bulk) 接受 NDJSON（换行符分隔 JSON）格式的日志。每行只包含一个 JSON 值，由换行符分隔。

如果您使用的是不记名令牌身份验证，请先完成中的设置步骤，设置不记名令牌身份验证然后再继续。

请求格式

每行发送一个 JSON 值，以 \n (LF) 或 \r\n (CRLF) 分隔。空行会被静默忽略。

{"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都被接受为内容类型。

接受的 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"}]

此单行生成 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"}'

响应

成功（接受所有活动）：

HTTP 200 OK
{}

部分成功（某些事件被拒绝）：

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

该rejectedLogRecords字段是被拒绝的事件的总数。该errorMessage字段包含按拒绝原因划分的 JSON 编码细分：

最佳实践

对事件进行批处理

为了提高性能和效率：

错误处理

在应用程序中实现正确的错误处理。常见的 HTTP 状态码：

限制