integration-testing

集成测试

何时使用

在任务涉及以下内容时，加载此技能：

• 编写或调试管道测试固件（.log/.json 输入、*-expected.json 输出、配置文件）
• 设置或调试系统测试（_dev/test/system/、_dev/deploy/、模拟 API、0 命中失败）
• 为失败路径、API 错误处理或软件包升级编写脚本测试

何时不使用

请勿将此技能作为以下内容的主要指南：

• 摄取管道处理器的设计和架构（ingest-pipelines）
• CEL 程序开发（cel-programs）
• 广泛的 elastic-package 命令选择和栈生命周期（elastic-package-cli）

参考文件——加载与测试类型匹配的文件

测试类型	加载时机	参考文件
管道测试	编写固件、配置文件、预期输出或调试管道测试失败时	references/pipeline-testing.md
系统测试（通用）	任何系统测试工作都应始终加载——配置字段、命令、清理、调试	references/system-testing.md
脚本测试	txtar 失败/错误测试、升级测试、嵌入 txtar 的模拟服务	references/script-testing.md

系统测试输入类型专用参考文件

除了通用的 system-testing.md 外，还需加载与你的数据流输入类型匹配的参考文件：

输入类型	参考文件
cel	references/system-testing-cel.md
tcp、udp	references/system-testing-tcp-udp.md
http_endpoint	references/system-testing-http-endpoint.md
logfile、filestream	references/system-testing-logfile.md
kafka、gcp-pubsub	references/system-testing-kafka-pubsub.md
aws-s3、gcs、azure-blob-storage、azure-eventhub	references/system-testing-cloud-skip.md

当某个集成支持多种输入类型时，加载通用参考文件以及每种适用输入类型对应的参考文件。

当一项任务涉及多种测试类型时（例如，端到端创建新的数据流），加载所有适用的参考文件。

参考资料

• references/pipeline-testing.md — 目录布局、命名约定、fixture 格式、配置选项、预期输出格式与审查、核心工作流、fixture 场景覆盖范围、数据匿名化、故障排除
• references/system-testing.md — 通用系统测试参考：必需的布局、配置字段、核心命令、拆卸失败、sample_event.json 验证、常规调试
• references/system-testing-cel.md — CEL 模拟 API 接线、CEL 的 0 命中调试、变量捕获模式
• references/system-testing-tcp-udp.md — 使用 elastic/stream 的 TCP/UDP 日志发送器模式、信号协调、端口对齐
• references/system-testing-http-endpoint.md — 使用 STREAM_PROTOCOL=webhook 的 webhook/HTTP 端点测试、身份验证标头
• references/system-testing-logfile.md — 用于 logfile/filestream 输入的 Alpine 容器 + SERVICE_LOGS_DIR 模式
• references/system-testing-kafka-pubsub.md — Kafka broker + 流生产者、Pub/Sub 模拟器模式
• references/system-testing-cloud-skip.md — 跳过云存储输入系统测试的时机和原因（aws-s3、gcs、azure-blob-storage、azure-eventhub）
• references/script-testing.md — txtar 格式、环境冒烟测试、系统级骨架、模拟服务 docker-compose 和 config.yml、升级测试模式、注意事项、完整的 o365 示例
• references/builder-setup-subagent-guidance.md — 用于接线数据采集的子 Agent 操作手册（docker-compose、示例日志、Agent 流模板、系统测试配置、清理 manifest 变量），适用于非 CEL 数据流。协调器通过在任务提示词中传入此文件的路径来分派子 Agent；子 Agent 会在自己的全新上下文中自行读取该文件。不要将其内容嵌入或粘贴到任务提示词中。
• references/builder-system-test-subagent-guidance.md — 用于在管道工作完成后运行 elastic-package test system --generate 的子 Agent 操作手册（适用于任何可测试的输入）。分派规则同上：协调器传入路径，由子 Agent 自行读取文件。