« Websocket 输入 覆盖输入设置 »
Elastic 文档 ›Filebeat 参考 [8.14] ›配置 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:
« Websocket 输入 覆盖输入设置 »