› ›

系统模块

编辑

系统模块

编辑

system 模块收集并解析由常见基于 Unix/Linux 发行版的系统日志服务创建的日志。

运行模块时，它会在后台执行一些任务

设置日志文件的默认路径（但不用担心，您可以覆盖默认值）
确保每个多行日志事件都作为单个事件发送
使用 Elasticsearch Ingest Pipeline 解析和处理日志行，将数据塑造成适合在 Kibana 中可视化的结构
部署用于可视化日志数据的仪表板

阅读快速入门，了解如何配置和运行模块。

兼容性

编辑

此模块已通过 Ubuntu 12.04、Centos 7 和 macOS Sierra 等操作系统的日志测试。

此模块不适用于 Windows。

配置模块

编辑

您可以通过在 modules.d/system.yml 文件中指定变量设置或覆盖命令行中的设置，进一步优化 system 模块的行为。

您必须启用模块中的至少一个文件集。文件集默认情况下是禁用的。

以下示例显示了如何在 modules.d/system.yml 文件中设置路径以覆盖 syslog 和授权日志的默认路径

- module: system
  syslog:
    enabled: true
    var.paths: ["/path/to/log/syslog*"]
  auth:
    enabled: true
    var.paths: ["/path/to/log/auth.log*"]

要在命令行中指定相同的设置，您可以使用

-M "system.syslog.var.paths=[/path/to/log/syslog*]" -M "system.auth.var.paths=[/path/to/log/auth.log*]"

变量设置

编辑

每个文件集都有单独的变量设置来配置模块的行为。如果您未指定变量设置，则 system 模块将使用默认值。

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

在命令行中指定设置时，请记住在设置前添加模块名称前缀，例如 system.syslog.var.paths 而不是 syslog.var.paths。

`syslog` 文件集设置

编辑

var.paths: 指定查找日志文件位置的基于 glob 的路径数组。此处也支持 Go Glob 支持的所有模式。例如，您可以使用通配符从预定义级别的子目录中获取所有文件：/path/to/log/*/*.log。这将获取 /path/to/log 子文件夹中的所有 .log 文件。它不会获取 /path/to/log 文件夹本身中的日志文件。如果此设置为空，Filebeat 将根据您的操作系统选择日志路径。

`auth` 文件集设置

编辑

var.paths: 指定查找日志文件位置的基于 glob 的路径数组。此处也支持 Go Glob 支持的所有模式。例如，您可以使用通配符从预定义级别的子目录中获取所有文件：/path/to/log/*/*.log。这将获取 /path/to/log 子文件夹中的所有 .log 文件。它不会获取 /path/to/log 文件夹本身中的日志文件。如果此设置为空，Filebeat 将根据您的操作系统选择日志路径。
var.tags: 要在事件中包含的标签列表。包含 forwarded 表示事件并非源自此主机，并导致 host.name 不添加到事件中。包含 preserve_orginal_event 会使 pipeline 保留 event.original 中的原始日志。默认为 []。