Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

使用 HLC 端点发送日志（HLC 日志）

HLC 日志端点 (/services/collector/event) 基于 HTTP 日志收集器 (HLC) 格式。

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

输入模式

每个事件都是一个带有必填"event"字段的 JSON 对象。可选的元数据字段："time""host"、"source"、"sourcetype"、、"index"。

单项赛事：

{"event":"Hello world!","time":1486683865.0}

JSON 事件数组：

[
  {"event":"msg1","time":1486683865.0},
  {"event":"msg2","time":1486683866.0}
]

连接/批处理事件（没有数组包装器）：

{"event":"msg1","time":1486683865.0}{"event":"msg2","time":1486683866.0}

事件字段（必填）

该"event"字段是必填字段。它的值可以是任何 JSON 类型：

{"event":"a string message"}
{"event":{"message":"structured data","severity":"INFO"}}
{"event":42}
{"event":true}

不带"event"字段的对象会被静默跳过：

{"message":"this is skipped — no event field"}

时间字段（可选）

该"time"字段以纪元秒（不是毫秒）为单位，可选小数表示亚秒精度。

Content-Type

只application/json被接受。

接受的 JSON 值类型

终端节点格式

HLC 端点 URL 遵循以下格式：

https://logs.<region>.amazonaws.com/services/collector/event?logGroup=<name>&logStream=<name>[&entityName=<name>&entityEnvironment=<environment>]

必填参数：

可选参数：

您可以选择通过添加以下查询参数将日志事件与Service实体相关联。由于通过 HLC 端点发送的日志是自定义遥测数据，因此它们不会自动与实体关联。通过提供这些参数， CloudWatch Logs 会创建一个KeyAttributes.Type设置为Service的实体，并将其与您的日志事件相关联。这使中与 Explore 相关的功能可以 CloudWatch 将这些日志与来自同一服务的其他遥测（指标、跟踪和日志）关联起来，从而更轻松地对不同信号类型的应用程序进行故障排除和监控。有关实体和相关遥测的更多信息，请参阅向自定义遥测添加相关信息。

请求格式

使用 HTTP POST 发送带有以下标头和正文的日志：

标题：

正文格式：

请求正文应采用 JSON 格式，并包含一系列事件：

{
    "event": [
        {
            "time": 1730141374.001,
            "event": "Application started successfully",
            "host": "web-server-1",
            "source": "application.log",
            "severity": "info"
        },
        {
            "time": 1730141374.457,
            "event": "User login successful",
            "host": "web-server-1",
            "source": "auth.log",
            "user": "john.doe"
        }
    ]
}

字段描述：

可以根据需要添加其他自定义字段。

示例请求

curl -X POST "https://logs.<region>.amazonaws.com/services/collector/event?logGroup=MyLogGroup&logStream=MyStream" \
  -H "Authorization: Bearer ACWL<token>" \
  -H "Content-Type: application/json" \
  -d '{"event":{"message":"User logged in","user_id":"u-123"},"time":1486683865.0,"host":"web-01","source":"auth-service"}'

最佳实践

对事件进行批处理

为了获得更好的性能和效率：

错误处理

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

限制