Cloudwatch 输出插件

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

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

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

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

用于不具有 CW_dimensions 字段的事件的默认维度 [ name, value, …​ ]

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

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

用于为每个事件设置不同命名空间的字段名称。注意：每次 API 调用只能将一个命名空间发送到 CloudWatch，因此设置不同的命名空间将增加 API 调用的数量，并且这些调用会花费资金。

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

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

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

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

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

在强制调用 CloudWatch API 之前，要将多少个事件排队，而不是按照 timeframe 计划进行调用？将其设置为您将发送到 CloudWatch 的每个时间段的事件数，以避免额外的 API 调用。

AWS 区域

AWS Secret Access Key

用于临时凭证的 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。强烈建议在配置中设置此 ID。当您有两个或多个相同类型的插件时，这尤其有用。例如，如果您有 2 个 cloudwatch 输出。在这种情况下添加命名 ID 将有助于在使用监控 API 时监控 Logstash。

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