Statsd 输出插件

对于默认情况下未捆绑的插件，可以通过运行 bin/logstash-plugin install logstash-output-statsd 轻松安装。有关更多详细信息，请参阅 使用插件。

有关插件的问题，请在 讨论 论坛中发布主题。对于错误或功能请求，请在 Github 中打开问题。有关 Elastic 支持的插件列表，请参阅 Elastic 支持矩阵。

statsd 是一个网络守护程序，用于聚合统计信息（例如计数器和计时器），并通过 UDP 发送到后端服务（例如 Graphite 或 Datadog）。基本思想是，您将指标发送到 statsd，每隔几秒钟它就会将聚合值发送到后端。示例聚合包括总和、平均值和最大值、它们的标准差等。此插件使根据 Logstash 事件中的数据发送此类指标变得容易。

您可以在此处了解 statsd

此插件与 Logstash 一起使用的典型示例包括按响应代码计数 HTTP 点击次数、对提供服务的总字节数进行求和以及跟踪请求处理时间的第 50 个和第 95 个百分位数。

发送到 statsd 的每个指标都有一个点分隔的路径、一个类型和一个值。指标路径由 namespace 和 sender 选项以及根据指标类型选择的指标名称构建。总的来说，指标路径将遵循以下模式

namespace.sender.metric

关于此插件，默认命名空间为“logstash”，默认发送者为 host 字段，指标名称取决于在 increment、decrement、timing、count、set 或 gauge 选项中设置的指标名称。在指标路径中，冒号 (":")、竖线 ("|") 和“@”符号是保留的，将被下划线 ("_") 替换。

示例

output {
  statsd {
    host => "statsd.example.org"
    count => {
      "http.bytes" => "%{bytes}"
    }
  }
}

如果在名为 hal9000 的主机上运行，如果当前事件的 bytes 字段中包含 123，则上述配置将向 statsd 发送以下指标

logstash.hal9000.http.bytes:123|c

此插件支持以下配置选项，以及后面描述的 通用选项。

另请参阅 通用选项，了解所有输出插件支持的选项列表。

以下配置选项受所有输出插件支持

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