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 indexer 上的一个输出插件可以服务所有事件（当然，这些事件在 Logstash 发件人中设置了字段）。

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

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

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

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

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

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

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

AWS 区域

AWS 密钥访问密钥

用于临时凭证的 AWS 会话令牌

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

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

请参阅 Rufus Scheduler 文档以了解允许值的解释

用于没有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"
  }
}