› › ›

Unix 输入

此功能为 Beta 版本，可能会发生更改。其设计和代码不如正式 GA 功能成熟，按“原样”提供，不提供任何保证。Beta 版本功能不受官方 GA 功能的支持 SLA 约束。

使用 unix 输入通过面向流的 Unix 域套接字读取事件。

配置示例

filebeat.inputs:
- type: unix
  max_message_size: 10MiB
  path: "/var/run/filebeat.sock"

配置选项

编辑

unix 输入支持以下配置选项以及稍后描述的通用选项。

`max_message_size`

编辑

通过套接字接收的消息的最大大小。默认值为 20MiB。

`path`

编辑

将接收事件的 Unix 套接字的路径。

`socket_type`

编辑

将接收事件的 Unix 套接字的类型。有效值为 stream 和 datagram。默认值为 stream。

`group`

编辑

将由 Filebeat 创建的 Unix 套接字的所有者组。默认值是 Filebeat 运行的用户的主组名。此选项在 Windows 上被忽略。

`mode`

编辑

将由 Filebeat 创建的 Unix 套接字的文件模式。这应该是一个八进制字符串形式的文件模式。默认值是系统默认值（通常为 0755）。

`framing`

编辑

指定用于拆分传入事件的成帧方式。可以是 delimiter 或 rfc6587。delimiter 使用 line_delimiter 中指定的字符来拆分传入事件。rfc6587 支持八位字节计数和非透明成帧，如 RFC6587 中所述。line_delimiter 用于拆分非透明成帧中的事件。默认值为 delimiter。

`line_delimiter`

编辑

指定用于拆分传入事件的字符。默认值为 *\n*。

`max_connections`

编辑

在任何给定时间要接受的最大连接数。

`timeout`

编辑

在连接关闭之前的不活动秒数。默认值为 300s。

有关更多信息，请参阅 SSL。

指标

编辑

此输入在 HTTP 监控端点下公开指标。这些指标在 /inputs 路径下公开。它们可用于观察输入的活动。

指标	描述
`path`	Unix 套接字的路径。
`received_events_total`	已接收的数据包（事件）总数。
`received_bytes_total`	已接收的总字节数。
`arrival_period`	连续数据包之间的时间的直方图，单位为纳秒。
`processing_time`	处理数据包所用时间的直方图，单位为纳秒。

通用选项

编辑

所有输入都支持以下配置选项。

`enabled`

编辑

使用 enabled 选项启用和禁用输入。默认情况下，enabled 设置为 true。

`tags`

编辑

Filebeat 在每个已发布事件的 tags 字段中包含的标签列表。标签使您可以在 Kibana 中轻松选择特定事件，或者在 Logstash 中应用条件筛选。这些标签将附加到通用配置中指定的标签列表。

示例

filebeat.inputs:
- type: unix
  . . .
  tags: ["json"]

`fields`

编辑

您可以指定的可选字段，用于向输出添加其他信息。例如，您可以添加可用于筛选日志数据的字段。字段可以是标量值、数组、字典或这些值的任何嵌套组合。默认情况下，您在此处指定的字段将分组在输出文档中的 fields 子字典下。要将自定义字段存储为顶级字段，请将 fields_under_root 选项设置为 true。如果通用配置中声明了重复字段，则其值将被此处声明的值覆盖。

filebeat.inputs:
- type: unix
  . . .
  fields:
    app_id: query_engine_12

`fields_under_root`

编辑

如果将此选项设置为 true，则自定义字段将作为输出文档中的顶级字段存储，而不是分组在 fields 子字典下。如果自定义字段名称与 Filebeat 添加的其他字段名称冲突，则自定义字段将覆盖其他字段。

`processors`

编辑

要应用于输入数据的处理器列表。

有关在配置中指定处理器的信息，请参阅 处理器。

`pipeline`

编辑

为此输入生成的事件设置的 Ingest Pipeline ID。

也可以在 Elasticsearch 输出中配置 Pipeline ID，但此选项通常会生成更简单的配置文件。如果在输入和输出中都配置了 Pipeline，则使用输入中的选项。

`keep_null`

编辑

如果将此选项设置为 true，则具有 null 值的字段将发布在输出文档中。默认情况下，keep_null 设置为 false。

`index`

编辑

如果存在，此格式化字符串会覆盖此输入（对于 Elasticsearch 输出）的事件索引，或者设置事件元数据的 raw_index 字段（对于其他输出）。此字符串只能引用代理名称和版本以及事件时间戳；要访问动态字段，请使用 output.elasticsearch.index 或处理器。

示例值："%{[agent.name]}-myindex-%{+yyyy.MM.dd}" 可能会扩展为 "filebeat-myindex-2019.11.01"。

`publisher_pipeline.disable_host`

编辑

默认情况下，所有事件都包含 host.name。可以将此选项设置为 true 以禁用向所有事件添加此字段。默认值为 false。

« UDP 输入 winlog 输入 »