接收器 - Amazon CloudWatch
要求和限制

接收器

接收器定义了已处理日志数据的发送目标。每条管道必须恰好有一个接收器。目前，仅支持 CloudWatch Logs 接收器。

按来源类型划分的接收器行为
源类型 日志组配置 行为
CloudWatch Logs 必须使用 @original 事件发送回其原始日志组
S3 自定义日志组路径 事件将发送到指定的日志组
第三方 API 自定义日志组路径 事件将发送到指定的日志组
配置

使用以下参数配置接收器：

例非 CloudWatch Logs 来源配置
sink:
  cloudwatch_logs:
    log_group: "/aws/my-application/logs"
例 CloudWatch Logs 来源配置
sink:
  cloudwatch_logs:
    log_group: "@original"
Parameters
log_group（必需）

已处理事件将发送到的 CloudWatch Logs 日志组的名称。对于采用非 cloudwatch_logs 来源的管道，此项必须是现有日志组的名称。对于采用 cloudwatch_logs 来源的管道，唯一允许的值是 @original。

要求和限制

日志组存在

如果使用 AWS 管理控制台创建，CloudWatch 将尝试创建指定的日志组和相应的资源策略（如果在使用非 CloudWatch 日志来源时指定的日志组不存在）。否则，在创建管道之前，指定的日志组必须存在。

事件大小

在处理之后，每个日志事件的大小不能超过 256 KB。

日志组保留

管道使用在目标日志组上配置的保留设置。

日志组和资源策略

写入日志组的管道需要使用 CloudWatch Logs 资源策略，使用 cloudwatch_logs 来源的管道除外。使用 AWS 管理控制台 配置管道时，CloudWatch 将在需要时尝试添加资源策略。如果您使用 AWS CLI 或 API 创建管道，则必须手动创建策略并使用 logs:PutResourcePolicy 请求进行添加。有关更多信息，请参阅 资源策略。

跨区域支持

目标日志组和管道必须位于同一区域内。

重要

对于使用 cloudwatch_logs 来源类型的管道：

  • 必须使用 @original 作为日志组的值。

  • 事件总是发送回其原始日志组。

  • 在管道的整个生命周期中，原始日志组必须存在。

  • 带有处理器的管道会改变从 AWS 服务中日志拦截的原始 CloudWatch 日志组中的日志事件。

注意

日志事件受 CloudWatch Logs 配额和限制的约束。