Cloudwatch 输出插件

此插件使用 AWS SDK 并支持多种获取凭据的方式，将按以下顺序尝试：

包含 AWS 凭据哈希的 YAML 文件的路径。仅当未设置 access_key_id 和 secret_access_key 时，才会加载此文件。文件内容应如下所示

    :access_key_id: "12345"
    :secret_access_key: "54321"

一次调用 CloudWatch API 可以提供多少个数据点

用于没有 CW_dimensions 字段的事件的默认维度 [名称，值，…]

用于在事件指标上设置维度的字段名称。如果事件中存在此处的字段名称，则必须包含一个或多个键值对的数组，例如…​ add_field => [ "CW_dimensions", "Environment", "CW_dimensions", "prod" ] 或等效地…​ add_field => [ "CW_dimensions", "Environment" ] add_field => [ "CW_dimensions", "prod" ]

用于在事件上设置指标名称的字段名称。此插件的作者建议在输入和过滤器中向事件添加此字段，而不是使用每个输出的默认设置，以便 Logstash 索引器上的一个输出插件可以服务所有事件（当然，这些事件在 Logstash 发货器上设置了字段）。

用于为每个事件设置不同命名空间的字段名称。注意：每次 API 调用只能发送一个命名空间，因此设置不同的命名空间会增加 API 调用的次数，而 API 调用会产生费用。

用于在事件指标上设置单位的字段名称

用于在事件指标上设置值（浮点数）的字段名称

用于没有 CW_metricname 字段的事件的默认指标名称。注意：如果提供了此选项，则通过此输出插件的所有事件都将被聚合并发送到 CloudWatch，因此请谨慎使用。此外，在提供此选项时，您可能还需要使用事件类型、标签和字段匹配来限制事件通过此输出插件。

用于没有 CW_namespace 字段的事件的默认命名空间

如果需要，代理服务器的 URI

在强制调用 CloudWatch API 之前，要排队的事件数量，早于 timeframe 计划。将此设置为将发送到 CloudWatch 的每个时间段的事件数量，以避免额外的 API 调用。

AWS 区域

AWS 密钥

AWS 临时凭证的会话令牌

常量 aggregate_key 成员 单位 多久发送一次数据到 CloudWatch。这不会影响事件时间戳，事件将始终具有其实际时间戳（精确到分钟）发送到 CloudWatch。

只有在有数据要发送时，我们才会调用 API。

有关允许值的说明，请参阅 Rufus Scheduler 文档 here

用于没有 CW_unit 字段的事件的默认单位。如果设置此选项，则可能需要同时设置“value”选项。

使用与 AWS SDK 一起提供的捆绑 CA 证书来验证 SSL 对等证书。对于默认证书不可用（例如 Windows）的情况，可以将其设置为 true。

用于没有 CW_value 字段的事件的默认值。如果提供，则必须是可转换为浮点数的字符串，例如…“1”、“2.34”、“.5”和“0.67”。如果设置此选项，则可能需要同时设置 unit 选项。

用于输出数据的编解码器。输出编解码器是一种方便的方法，用于在数据离开输出之前对其进行编码，而无需在 Logstash 管道中使用单独的过滤器。

禁用或启用此特定插件实例的指标日志记录。默认情况下，我们会记录所有可以记录的指标，但您可以为特定插件禁用指标收集。

在插件配置中添加一个唯一的 ID。如果未指定 ID，Logstash 将生成一个。强烈建议在配置中设置此 ID。当您有两个或多个相同类型的插件时，这尤其有用。例如，如果您有两个 cloudwatch 输出。在这种情况下，添加一个命名 ID 将有助于在使用监控 API 时监控 Logstash。

output {
  cloudwatch {
    id => "my_plugin_id"
  }
}