« winlog 输入 覆盖输入设置 »
Elastic 文档 ›Filebeat 参考 [8.17] ›配置 Filebeat

配置模块

编辑

配置模块

编辑

使用 Filebeat 模块是可选的。如果您正在使用不支持的日志类型，或者想要使用不同的设置，您可以决定手动配置输入。

Filebeat 模块提供了一种快速开始处理常用日志格式的方法。它们包含默认配置、Elasticsearch 摄取管道定义和 Kibana 仪表板，以帮助您实施和部署日志监控解决方案。

您可以在 modules.d 目录（推荐）或 Filebeat 配置文件中配置模块。

在启用模块的情况下运行 Filebeat 之前，请确保您还设置了环境以使用 Kibana 仪表板。有关更多信息，请参阅快速入门：安装和配置。

在具有 POSIX 文件权限的系统上，所有 Beats 配置文件都受所有权和文件权限检查的约束。有关更多信息，请参阅配置文件所有权和权限。

在 modules.d 目录中配置模块

编辑

modules.d 目录包含 Filebeat 中所有可用模块的默认配置。要启用或禁用 modules.d 下的特定模块配置，请运行modules enable 或 modules disable 命令。例如

filebeat modules enable nginx

默认配置假设您的数据位于您的操作系统期望的位置，并且模块的行为适合您的环境。要更改默认行为，请配置变量设置。有关可用设置的列表，请参阅模块下的文档。

对于高级用例，您还可以覆盖输入设置。

您可以使用 --modules 标志在运行时启用模块。如果您刚开始使用并想尝试一些功能，这将非常有用。在命令行中指定的任何模块都会与在配置文件或 modules.d 目录中启用的任何模块一起加载。如果存在冲突，则使用命令行中指定的配置。

在 filebeat.yml 文件中配置模块

编辑

如果可能，您应该使用 modules.d 目录中的配置文件。

但是，如果您是从以前版本的 Filebeat 升级的，并且不想将模块配置移动到 modules.d 目录，则直接在配置文件中配置模块是一种实用的方法。您可以继续在 filebeat.yml 文件中配置模块，但是您将无法使用 modules 命令来启用和禁用配置，因为该命令需要 modules.d 布局。

要在 filebeat.yml 配置文件中启用特定模块，请将条目添加到 filebeat.modules 列表中。列表中的每个条目都以短划线 (-) 开头，后跟该模块的设置。

以下示例显示了运行 nginx、mysql 和 system 模块的配置

filebeat.modules:
- module: nginx
  access:
  error:
- module: mysql
  slowlog:
- module: system
  auth:
« winlog 输入 覆盖输入设置 »