更新的版本已推出。如需获取最新信息，请参阅当前版本文档。
« 贡献文档 社区 Beats »
Elastic 文档 ›Beats 开发者指南 [8.14] ›贡献 Beats

测试

编辑

测试编辑

Beats 有一系列测试。本指南旨在帮助您了解不同测试套件的工作原理、使用方法以及如何添加新测试。

通常，主要有两个测试套件

  • 用 Go 编写的测试
  • 用 Python 编写的测试

用 Go 编写的测试使用 Go 测试包。用 Python 编写的测试依赖于 pytest，并需要 Go 代码编译后的可执行二进制文件。Python 测试使用特定配置和参数运行 Beat，并检查输出是否符合预期或日志中是否显示了正确的内容。

对于上述两个测试套件，都存在所谓的集成测试。Beats 中的集成测试需要外部系统（如 Elasticsearch）来测试与该服务的集成是否按预期工作。Beats 在其测试套件中提供了 Docker 容器和 docker-compose 文件来启动这些环境，但开发人员也可以在本地运行所需的服务。

运行 Go 测试编辑

可以通过运行 go test . 来在每个 Go 包中执行 Go 测试。这将执行所有不需要运行外部服务的测试。要运行 Beat 的所有非集成测试，请运行 mage unitTest。

所有 Go 测试都与被测试代码本身位于同一个包中，并且文件名中带有后缀 _test。大多数测试与其余代码位于同一个包中。一些应该与其余代码分开或不应该使用私有变量的测试位于 {packagename}_test 下。

运行 Go 集成测试编辑

集成测试使用 //go:build integration 构建标记进行标记，并使用 _integration_test.go 后缀。

要运行集成测试，请使用 mage goIntegTest 目标，该目标将使用 docker-compose 启动所需的服务并运行所有集成测试。

可以手动启动 docker-compose 服务，以便选择要运行的特定测试。以下是 filebeat 的示例

cd filebeat
# Pull and build the containers. Only needs to be done once unless you change the containers.
mage docker:composeBuild
# Bring up all containers, wait until they are healthy, and put them in the background.
mage docker:composeUp
# Run all integration tests.
go test ./filebeat/...  -tags integration
# Stop all started containers.
mage docker:composeDown

生成示例事件编辑

Go 测试支持生成要用作 fixture 的示例事件。

可以通过运行 go test --data 来执行此生成。Packetbeat 和 Metricbeat 支持此功能。

在 Metricbeat 中，从模块中运行以下命令：go test --tags integration,azure --data --run "TestData"。确保添加了相关标签（integration 是常见的，然后添加模块和指标集特定标签）。

关于标签的说明：--data 标志是 Metricbeat 和 Packetbeat 框架添加的自定义标志。如果标签不匹配，则该标志将不存在，因为相关代码将不会运行并且会被静默跳过（如果没有标签，Go 编译器将忽略测试文件，因此框架不会加载）。如果正在测试的指标集的构建标签中存在不同的标签（例如，GCP 计费指标集还需要 billing 标签），则可能会发生这种情况。

运行系统（集成）测试（Python 和 Go）编辑

系统测试在 tests/system（对于旧版 Python 测试）和 tests/integration（对于 Go 测试）目录中定义。它们需要一个可用的测试二进制文件和已设置的 Python 环境。

要创建测试二进制文件，请运行 mage buildSystemTestBinary。这将在 Beat 目录中创建测试二进制文件。要设置 Python 测试环境，请运行 mage pythonVirtualEnv，这将创建一个包含所有测试依赖项的虚拟环境并打印其位置。要激活它，具体说明取决于您的操作系统。请参阅 virtualenv 文档。

要运行系统和集成测试，请使用 mage pythonIntegTest 目标，该目标将使用 docker-compose 启动所需的服务并运行所有集成测试。与 Go 集成测试类似，可以手动完成各个步骤，以便选择要运行的测试

# Create and activate the system test virtual environment (assumes a Unix system).
source $(mage pythonVirtualEnv)/bin/activate

# Pull and build the containers. Only needs to be done once unless you change the containers.
mage docker:composeBuild

# Bring up all containers, wait until they are healthy, and put them in the background.
mage docker:composeUp

# Run all system and integration tests.
INTEGRATION_TESTS=1 pytest ./tests/system

# Stop all started containers.
mage docker:composeDown

Filebeat 的模块 Python 测试有额外的文档，可在 Filebeat 模块 指南中找到。

测试命令编辑

要列出所有 mage 命令，请运行 mage -l。以下是可用测试 Make 命令的简要概述

  • unit：Go 测试
  • unit-tests：带覆盖率报告的 Go 测试
  • integration-tests：在本地 docker 中使用服务的 Go 测试
  • integration-tests-environment：在 docker 中使用 docker 中服务的 Go 测试
  • fast-system-tests：Python 测试
  • system-tests：带覆盖率报告的 Python 测试
  • INTEGRATION_TESTS=1 system-tests：使用本地服务的 Python 测试
  • system-tests-environment：在 docker 中使用 docker 中服务的 Python 测试
  • testsuite：在 docker 环境中运行完整的测试套件
  • test：运行没有环境的 testsuite

有两个实验性测试命令

  • benchmark-tests：使用 -bench 标志运行 Go 测试
  • load-tests：使用 LOAD_TESTS=1 标志运行系统测试

覆盖率报告编辑

如果运行测试以创建测试覆盖率，则可以在 build/docs 下找到覆盖率报告文件。要从 .cov 文件中创建一个更易于阅读的文件，可以使用 make coverage-report。它在 build/coverage 目录中为每个报告创建一个 .html 文件，并创建一个 full.html 作为所有报告的摘要。

竞态检测编辑

可以通过设置环境变量 RACE_DETECTOR=1 来启用 Go 竞态检测器，从而运行所有测试。这适用于 Go 和 Python 中的测试。对于 Python，当标志更改时，必须重新编译测试二进制文件。启用竞态检测会降低测试速度。

« 贡献文档 社区 Beats »