常规参数配置

1. 全局参数

- name

当前节点的名称。如果此选项为空，则使用服务器的主机名。

名称作为agent.name字段包含在每个已发布的事务中。您可以使用名称对单个Beat发送的所有交易进行分组。

示例：

name: "my-shipper"

- tags

Beat包含在每个已发布事务的标签字段中的标签列表。

标记可以方便地按不同的逻辑属性对服务器进行分组。

例如，如果你有一个网络服务器集群，你可以在每个服务器上的Beat中添加“webservers”标签，然后在Kibana网络界面中使用过滤器和查询来获得整个服务器组的可视化。

示例：

tags: ["my-service", "hardware", "test"]

- fields

可指定的可选字段，用于向输出中添加附加信息。

字段可以是标量值、数组、字典，也可以是它们的任何嵌套组合。

默认情况下，您在此处指定的字段将分组到输出文档中的字段子字典下。

要将自定义字段存储为顶级字段，请将fields_under_root选项设置为true。

示例：

fields: {project: "myproject", instance-id: "574734885120952459"}

- fields_under_root

如果此选项设置为true，则自定义字段将作为顶级字段存储在输出文档中，而不是分组在字段子字典下。

如果自定义字段名称与其他字段名称冲突，则自定义字段将覆盖其他字段。

示例：

fields_under_root: true
fields:
  instance_id: i-10a64379
  region: us-east-1

- processors

应用于 beat 生成的数据的处理器列表

- max_procs

设置可以同时执行的CPU的最大数量。默认值是系统中可用的逻辑CPU的数量。

2. 常规参数

- registry.path

注册表的根路径。如果使用相对路径，则将其视为相对于数据路径。有关详细信息，请参阅目录布局部分。默认值为${path.data}/registry。

示例：

filebeat.registry.path: registry

备注：
注册表仅在刷新新事件时更新，而不是在预定义的时间段内更新。这意味着，如果存在TTL过期的某些状态，则只有在处理新事件时才会删除这些状态。

- registry.file_permissions

要应用于注册表数据文件的权限掩码。默认值为0600。

permissions选项必须是以八进制表示的有效Unix样式的文件权限掩码。在Go中，八进制记数法中的数字必须以0开头。

允许的最大掩码是0640。如果通过此设置指定了更高的权限掩码，则它将受到0027的umask的约束。

Windows不支持此选项。

示例：

0640: give read and write access to the file owner, and read access to members of the group associated with the file.
0600: give read and write access to the file owner, and no access to all others.

filebeat.registry.file_permissions: 0600

- registry.flush

超时值，用于控制何时将注册表项写入磁盘（刷新）。

当未写入的更新超过此值时，将触发对磁盘的写入。

当registry.flush设置为0s时，在成功发布每批事件后，注册表将写入磁盘。默认值为0s。

- registry.migrate_file

在Filebeat 7.0之前，注册表存储在一个文件中。当您升级到7.0时，Filebeat将自动迁移旧的Filebeat 6.x注册表文件以使用新的目录格式。

Filebeat在Filebeat.registry.path指定的位置查找文件。

如果在升级时更改了路径，请将filebeat.registry.migrate_file设置为指向旧的注册表文件。

- config_dir

【6.0.0中已弃用。请改用输入配置。】

包含其他输入配置文件的目录的完整路径。每个配置文件都必须以.yml结尾。

每个配置文件还必须指定完整的Filebeat配置层次结构，即使只处理每个文件的输入部分。

将忽略所有全局选项，如registry_file。

config_dir选项必须指向主Filebeat配置文件所在目录以外的目录。

如果指定的路径不是绝对路径，则视为相对于配置路径。有关详细信息，请参阅目录布局部分。

filebeat.config_dir: path/to/configs

- shutdown_timeout

在Filebeat关闭之前，Filebeat在关闭时等待发布者完成发送事件的时间。单位：秒

默认情况下，此选项处于禁用状态，并且Filebeat不会等待发布服务器完成发送事件后再关闭。

这意味着，当您重新启动Filebeat时，任何发送到输出但在Filebeat关闭前未得到确认的事件都会再次发送。

您可以配置shutdown_timeout选项，以指定Filebeat在关闭前等待发布服务器完成发送事件的最长时间。

如果在达到shutdown_timeout之前确认了所有事件，则Filebeat将关闭。

不建议对此选项进行设置，因为确定shutdown_timeout的正确值在很大程度上取决于Filebeat运行的环境和输出的当前状态。

示例：

filebeat.shutdown_timeout: 5s