    filter {
      cidr {
        add_tag => [ "testnet" ]
        address => [ "%{src_ip}", "%{dst_ip}" ]
        network => [ "192.0.2.0/24" ]
      }
    }

`network`

编辑

值类型是数组
默认值是[]

要检查的网络 IP 地址。示例

    filter {
      cidr {
        add_tag => [ "linklocal" ]
        address => [ "%{clientip}" ]
        network => [ "169.254.0.0/16", "fe80::/64" ]
      }
    }

`network_path`

编辑

值类型是路径
此设置没有默认值。

包含过滤器应检查的网络的外部文件的完整路径。网络由separator中定义的分隔符分隔。

    192.168.1.0/24
    192.167.0.0/16
NOTE: It is an error to specify both `network` and `network_path`.

`refresh_interval`

编辑

值类型是数字
默认值是600

当使用外部文件时，此设置将指示 Logstash 检查文件更新的频率（以秒为单位）。

`separator`

编辑

值类型是字符串
默认值是\n

用于从network_path指定的外部文件解析网络的分隔符。默认为换行符\n。

通用选项

编辑

所有过滤器插件都支持这些配置选项

设置	输入类型	必需
`add_field`	哈希	否
`add_tag`	数组	否
`enable_metric`	布尔值	否
`id`	字符串	否
`periodic_flush`	布尔值	否
`remove_field`	数组	否
`remove_tag`	数组	否

`add_field`

编辑

值类型是哈希
默认值是{}

如果此过滤器成功，请将任何任意字段添加到此事件。字段名称可以是动态的，并且可以使用 %{field} 包含事件的部分内容。

示例

    filter {
      cidr {
        add_field => { "foo_%{somefield}" => "Hello world, from %{host}" }
      }
    }

    # You can also add multiple fields at once:
    filter {
      cidr {
        add_field => {
          "foo_%{somefield}" => "Hello world, from %{host}"
          "new_field" => "new_static_value"
        }
      }
    }

如果事件具有字段"somefield" == "hello"，则此过滤器在成功时，如果存在，将添加字段foo_hello，其值为上述值，并且%{host}部分将替换为事件中的该值。第二个示例还将添加一个硬编码的字段。

`add_tag`

编辑

值类型是数组
默认值是[]

如果此过滤器成功，请向事件添加任意标签。标签可以是动态的，并且可以使用 %{field} 语法包含事件的部分内容。

示例

    filter {
      cidr {
        add_tag => [ "foo_%{somefield}" ]
      }
    }

    # You can also add multiple tags at once:
    filter {
      cidr {
        add_tag => [ "foo_%{somefield}", "taggedy_tag"]
      }
    }

如果事件具有字段"somefield" == "hello"，则此过滤器在成功时将添加一个标签foo_hello （第二个示例当然会添加一个taggedy_tag标签）。

`enable_metric`

编辑

值类型是布尔值
默认值是true

为此特定插件实例禁用或启用指标日志记录。默认情况下，我们会记录所有可以记录的指标，但您可以禁用特定插件的指标收集。

`id`

编辑

值类型是字符串
此设置没有默认值。

向插件配置添加唯一的 ID。如果未指定 ID，则 Logstash 将生成一个 ID。强烈建议在配置中设置此 ID。当您有两个或多个相同类型的插件时，这尤其有用，例如，如果您有 2 个 cidr 过滤器。在这种情况下添加命名 ID 将有助于在使用监视 API 时监视 Logstash。

    filter {
      cidr {
        id => "ABC"
      }
    }

id 字段中的变量替换仅支持环境变量，不支持使用密钥存储中的值。

`periodic_flush`

编辑

值类型是布尔值
默认值是false

定期调用过滤器刷新方法。可选。

`remove_field`

编辑

值类型是数组
默认值是[]

如果此过滤器成功，则从此事件中删除任意字段。字段名称可以是动态的，并且可以使用 %{field} 包含事件的部分内容。示例

    filter {
      cidr {
        remove_field => [ "foo_%{somefield}" ]
      }
    }

    # You can also remove multiple fields at once:
    filter {
      cidr {
        remove_field => [ "foo_%{somefield}", "my_extraneous_field" ]
      }
    }

如果事件具有字段"somefield" == "hello"，则此过滤器在成功时，如果存在，将删除名称为 foo_hello 的字段。第二个示例将删除一个额外的非动态字段。

`remove_tag`

编辑

值类型是数组
默认值是[]

如果此过滤器成功，则从此事件中删除任意标签。标签可以是动态的，并且可以使用 %{field} 语法包含事件的部分内容。

示例

    filter {
      cidr {
        remove_tag => [ "foo_%{somefield}" ]
      }
    }

    # You can also remove multiple tags at once:
    filter {
      cidr {
        remove_tag => [ "foo_%{somefield}", "sad_unwanted_tag"]
      }
    }

如果事件具有字段"somefield" == "hello"，则此过滤器在成功时，如果存在，将删除标签 foo_hello。第二个示例还将删除一个不想要的标签。

« Bytes 过滤器插件 Cipher 过滤器插件 »