Statsd 输出插件

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

有关插件的问题，请在Discuss论坛中开一个主题。对于错误或功能请求，请在Github中打开一个 issue。有关 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 选项中设置的指标名称。在指标路径中，冒号（“:”）、竖线（“|”）和 at 符号（“@”）是保留的，将替换为下划线（“_”）。

示例

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"
  }
}