加载中

创建 Metricbeat 模块

Metricbeat 模块用于将多个指标集组合在一起，并实现指标集的共享功能。在大多数情况下，不需要实现模块，并且会自动选择默认模块实现。

完成模块的配置和文档文件非常重要。当您通过运行 make create-metricset 创建新的指标集时，这些文件的默认版本会在 _meta 目录中生成。

模块文件

  • config.yml 和 config.reference.yml
  • docs.asciidoc
  • fields.yml

在更新任何这些文件后，请确保在您的 beat 目录中运行 make update，以便更新所有生成的文件。

config.yml 和 config.reference.yml

config.yml 文件包含基本配置选项，如下所示

- module: {module}
  metricsets: ["{metricset}"]
  enabled: false
  period: 10s
  hosts: ["localhost"]

它包含模块名称、您的指标集和默认周期。如果您的模块中有多个指标集，请确保扩展 metricset 数组

metricsets: ["{metricset1}", "{metricset2}"]

full.config.yml 文件是可选的，默认情况下具有与 config.yml 相同的内容。它用于添加和记录更高级的配置选项，这些选项不应包含在默认提供的最小配置文件中。

docs.asciidoc

docs.asciidoc 文件包含有关您的模块的文档。在生成文档期间，默认配置文件将附加到 docs。使用此文件更详细地描述您的模块，并记录特定的配置选项。

This is the {module} module.

fields.yml

fields.yml 文件包含指标集中字段的顶层结构。它与每个指标集中的 fields.yml 文件结合使用，以生成字段的模板和文档。

默认文件如下所示

- key: {module}
  title: "{module}"
  release: beta
  description: >
    {module} module
  fields:
    - name: {module}
      type: group
      description: >
      fields:

请确保至少更新模块的描述。

测试

在模块包中使用 testing.go 文件来共享指标集之间的一些测试功能是一种常见的模式。此文件名称中没有 _test.go，否则它将不会为子包编译。

要查看 testing.go 文件的示例，请查看 mysql 模块。

手动测试 Metricbeat 模块

要手动测试 Metricbeat 模块，请按照以下步骤操作。

首先，我们必须构建可用于模块的 Docker 镜像。Dockerfile 位于每个模块文件夹中的 _meta 文件夹中。例如，让我们以 MySQL 模块为例。

这些步骤假设您已从 Github 检出 Beats 存储库，并且位于 beats 目录中。首先，我们必须进入上面提到的 _meta 文件夹，并构建名为 metricbeat-mysql 的 Docker 镜像

$ cd metricbeat/module/mysql/_meta/
$ docker build -t metricbeat-mysql .
...
Removing intermediate container 0e58cfb7b197
 ---> 9492074840ea
Step 5/5 : COPY test.cnf /etc/mysql/conf.d/test.cnf
 ---> 002969e1d810
Successfully built 002969e1d810
Successfully tagged metricbeat-mysql:latest

在我们运行刚创建的容器之前，我们还需要知道要公开哪个端口。该端口列在 metricbeat/{{module}}/_meta/env 文件中

$ cat env
MYSQL_DSN=root:test@tcp(mysql:3306)/
MYSQL_HOST=mysql
MYSQL_PORT=3306

正如我们所看到的，端口是 3306。我们现在拥有启动本地 MySQL 服务的所有信息

$ docker run -p 3306:3306 -e MYSQL_ROOT_PASSWORD=secret metricbeat-mysql

这将启动容器，您现在可以使用它来测试 MySQL 模块。

要使用该模块运行 Metricbeat，我们需要构建二进制文件，首先启用该模块。现在的假设是您已返回到 beats 文件夹路径

$ cd metricbeat
$ mage build
$ ./metricbeat modules enable mysql

这将启用该模块并将文件 metricbeat/modules.d/mysql.yml.disabled 重命名为 metricbeat/modules.d/mysql.yml。根据我们的 文档，我们应该指定用户名和密码来使用 MySQL。查看文档始终是一个好主意，以便了解是否也提供了预构建的仪表板。因此，稍微调整一下配置，它看起来像这样

$ cat modules.d/mysql.yml

# Module: mysql
# Docs: /beats/docs/reference/ingestion-tools/beats-metricbeat/metricbeat-module-mysql.md

- module: mysql
  metricsets:
    - status
  #  - galera_status
  period: 10s

  # Host DSN should be defined as "user:pass@tcp(127.0.0.1:3306)/"
  # or "unix(/var/lib/mysql/mysql.sock)/",
  # or another DSN format supported by <https://github.com/Go-SQL-Driver/MySQL/>.
  # The username and password can either be set in the DSN or using the username
  # and password config options. Those specified in the DSN take precedence.
  hosts: ["tcp(127.0.0.1:3306)/"]

  # Username of hosts. Empty by default.
  username: root

  # Password of hosts. Empty by default.
  password: secret

现在它正在将数据发送到您的本地 Elasticsearch 实例。如果您需要修改 mysql 配置，请调整 modules.d/mysql.yml 并重启 Metricbeat。

为单个模块运行环境测试

所有环境都使用 docker 设置。make integration-tests-environment 和 make system-tests-environment 可用于运行所有模块的测试。如果您正在开发一个模块，则只为一个模块运行测试并直接在您的机器上运行它会很方便。

首先，您需要启动要测试的模块的环境，并将端口公开到您的本地计算机。为此，您可以在 metricbeat 目录中运行以下命令

MODULE=apache PORT=80 make run-module

注意：此处以端口 80 的 apache 模块为例。您必须在此处放置您自己的模块的名称和端口。

这将启动环境，您必须等到服务完全启动。之后，您可以运行需要环境的测试

MODULE=apache make test-module

这将运行集成和系统测试，连接到您的 docker 容器中的环境。

© . All rights reserved.