Metrics 过滤器插件
编辑Metrics 过滤器插件
编辑- 插件版本: v4.0.7
- 发布日期: 2021-01-20
- 变更日志
对于其他版本，请参阅 版本化插件文档。
获取帮助
编辑有关插件的问题，请在 Discuss 论坛中发起主题讨论。对于错误或功能请求，请在 Github 中提交问题。有关 Elastic 支持的插件列表，请参阅 Elastic 支持矩阵。
描述
编辑Metrics 过滤器可用于聚合指标。
Elasticsearch 2.0 不再允许使用带点的字段名。Metrics 过滤器插件的 3.0 版本更改了行为，以使用嵌套字段而不是点表示法来避免与 Elasticsearch 2.0+ 的版本冲突。请注意文档中的更改（使用下划线和子字段）。
例如，如果您有一个名为 response 的字段，它表示 HTTP 响应代码，并且您想统计每种响应的次数，您可以这样做
filter {
metrics {
meter => [ "http_%{response}" ]
add_tag => "metric"
}
}
默认情况下，指标每 5 秒刷新一次，或者根据 flush_interval 设置刷新。指标作为事件流中的新事件出现，并通过任何后续的过滤器以及输出。
通常，您需要为指标添加一个标签，并让一个输出显式地查找该标签。
刷新的事件将包含以下方式的所有 *meter* 和 *timer* 指标
meter 值
编辑对于 meter => "thing"，您将收到以下字段
- "[thing][count]" - 事件的总数
- "[thing][rate_1m]" - 1 分钟滑动窗口内的每秒事件速率
- "[thing][rate_5m]" - 5 分钟滑动窗口内的每秒事件速率
- "[thing][rate_15m]" - 15 分钟滑动窗口内的每秒事件速率
timer 值
编辑对于 timer => { "thing" => "%{duration}" }，您将收到以下字段
- "[thing][count]" - 事件的总数
- "[thing][rate_1m]" - 1 分钟滑动窗口内的每秒平均值
- "[thing][rate_5m]" - 5 分钟滑动窗口内的每秒平均值
- "[thing][rate_15m]" - 15 分钟滑动窗口内的每秒平均值
- "[thing][min]" - 此指标观察到的最小值
- "[thing][max]" - 此指标观察到的最大值
- "[thing][stddev]" - 此指标的标准差
- "[thing][mean]" - 此指标的平均值
- "[thing][pXX]" - 此指标的第 XX 个百分位数（请参阅
percentiles）
事件速率窗口的默认长度（1、5 和 15 分钟）可以通过 rates 选项进行配置。
示例：计算事件速率
编辑举个简单的例子，让我们跟踪有多少事件每秒通过 Logstash。
input {
generator {
type => "generated"
}
}
filter {
if [type] == "generated" {
metrics {
meter => "events"
add_tag => "metric"
}
}
}
output {
# only emit events with the 'metric' tag
if "metric" in [tags] {
stdout {
codec => line {
format => "rate: %{[events][rate_1m]}"
}
}
}
}
运行上述代码
% bin/logstash -f example.conf
rate: 23721.983566819246
rate: 24811.395722536377
rate: 25875.892745934525
rate: 26836.42375967113
我们可以看到输出包括我们事件的 1 分钟速率。
在实际应用中，您会将其发送到 Graphite 或其他指标存储中，如下所示
output {
graphite {
metrics => [ "events.rate_1m", "%{[events][rate_1m]}" ]
}
}
Metrics 过滤器配置选项
编辑此插件支持以下配置选项以及稍后描述的 常用选项。
| 设置 | 输入类型 | 必需 |
|---|---|---|
否 |
||
否 |
||
否 |
||
否 |
||
否 |
||
否 |
||
否 |
另请参阅 常用选项，以获取所有过滤器插件支持的选项列表。
常用选项
编辑所有过滤器插件都支持这些配置选项
| 设置 | 输入类型 | 必需 |
|---|---|---|
否 |
||
否 |
||
否 |
||
否 |
||
否 |
||
否 |
||
否 |
add_field
编辑- 值类型为 哈希
- 默认值为
{}
如果此过滤器成功，则将任何任意字段添加到此事件。字段名称可以是动态的，并使用 %{field} 包含事件的一部分。
示例
filter {
metrics {
add_field => { "foo_%{somefield}" => "Hello world, from %{host}" }
}
}
# You can also add multiple fields at once:
filter {
metrics {
add_field => {
"foo_%{somefield}" => "Hello world, from %{host}"
"new_field" => "new_static_value"
}
}
}
如果事件具有字段 "somefield" == "hello"，则此过滤器在成功时将添加字段 foo_hello（如果存在），其值为上述值，并且 %{host} 部分将替换为事件中的该值。第二个示例还将添加一个硬编码字段。
add_tag
编辑- 值类型为 数组
- 默认值为
[]
如果此过滤器成功，则将任意标签添加到事件。标签可以是动态的，并使用 %{field} 语法包含事件的一部分。
示例
filter {
metrics {
add_tag => [ "foo_%{somefield}" ]
}
}
# You can also add multiple tags at once:
filter {
metrics {
add_tag => [ "foo_%{somefield}", "taggedy_tag"]
}
}
如果事件具有字段 "somefield" == "hello"，则此过滤器在成功时将添加标签 foo_hello（第二个示例当然会添加 taggedy_tag 标签）。
id
编辑- 值类型为 字符串
- 此设置没有默认值。
向插件配置添加唯一的 ID。如果未指定 ID，Logstash 将生成一个。强烈建议在您的配置中设置此 ID。当您有两个或多个相同类型的插件时，这尤其有用，例如，如果您有两个 metrics 过滤器。在这种情况下，添加命名 ID 将有助于在使用监控 API 时监控 Logstash。
filter {
metrics {
id => "ABC"
}
}
id 字段中的变量替换仅支持环境变量，不支持使用密钥存储中的值。
remove_field
编辑- 值类型为 数组
- 默认值为
[]
如果此过滤器成功，则从此事件中删除任意字段。字段名称可以是动态的，并使用 %{field} 示例包含事件的一部分
filter {
metrics {
remove_field => [ "foo_%{somefield}" ]
}
}
# You can also remove multiple fields at once:
filter {
metrics {
remove_field => [ "foo_%{somefield}", "my_extraneous_field" ]
}
}
如果事件具有字段 "somefield" == "hello"，则此过滤器在成功时将删除名称为 foo_hello 的字段（如果存在）。第二个示例将删除另一个非动态字段。
remove_tag
编辑- 值类型为 数组
- 默认值为
[]
如果此过滤器成功，则从事件中删除任意标签。标签可以是动态的，并使用 %{field} 语法包含事件的一部分。
示例
filter {
metrics {
remove_tag => [ "foo_%{somefield}" ]
}
}
# You can also remove multiple tags at once:
filter {
metrics {
remove_tag => [ "foo_%{somefield}", "sad_unwanted_tag"]
}
}
如果事件具有字段 "somefield" == "hello"，则此过滤器在成功时将删除标签 foo_hello（如果存在）。第二个示例还将删除一个令人不快的、不需要的标签。