Statsd 输出插件

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

如果您对插件有任何疑问，请在 Discuss 论坛中发起主题讨论。对于错误或功能请求，请在 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 选项中设置的指标名称。在指标路径中，冒号（“:”）、竖线（“|”）和 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"
  }
}