UDP 插件配置说明
1. 概述
2. 配置选项（CONFIG_XXX）
Key=Value 的文本格式传入，每行一个配置项。以下列出所有支持的配置项及其说明。| 配置项 | 必填 | 默认值 | 说明 |
|---|---|---|---|
host | 是 | — | 目标主机地址，支持域名或 IPv4 / IPv6 地址 |
port | 否 | 80 | 目标服务端口 |
content | 否 | — | 待发送的数据内容 |
timeout | 否 | 12000 | 整体超时时间（单位：毫秒） |
response | 否 | — | 期望的响应内容，用于结果校验 |
checkType | 否 | 0 | 响应校验类型：0-不校验，1-完全匹配（回显），2-包含匹配，3-长度匹配 |
resplen | 否 | 0 | 期望的响应数据长度（仅在 checkType=3 时生效） |
2.1 配置项详细说明
host
test.example.com）或 IP 地址（如 192.168.1.1）。port
80。content
HEX: 开头，后接十六进制字符串（如 HEX:7BA41302001A）。BASE64: 开头，后接 Base64 编码字符串。timeout
checkType
0：不校验。不接收数据，不进行任何内容比对。1：回显完全匹配。将接收到的数据与本次发送的数据进行完全比对（逐字节相等）。此模式不读取 response 配置项。2：包含匹配。接收到的数据必须包含 response 配置项中指定的内容（支持子串匹配，区分大小写）。3：长度匹配。接收到的数据长度（字节数）必须等于 resplen 配置项中指定的数值。response
checkType=2 时生效。HEX: 和 BASE64: 前缀格式。resplen
checkType=3 时生效，表示期望的响应数据字节长度。3. 结果指标与计算方式
| 指标字段索引 | 指标名称 | 说明 |
|---|---|---|
0 | 总耗时 | 从拨测开始到结束的完整时间 |
1 | DNS 解析耗时 | 域名解析所花费的时间 |
3 | 发送耗时 | 从开始发送到成功发送完毕的时间 |
4 | 接收耗时 | 从发送完毕开始等待并接收响应数据的时间 |
3.1 指标计算逻辑
总耗时(0) = 拨测结束时间戳 - 拨测开始时间戳
DNS耗时(1) = DNS解析结束时间 - DNS解析开始时间
（仅在 host 为域名时产生；直接填写 IP 时该指标不会被设置，值为 0）
发送耗时(3) = 数据发送完成时间 - 发送开始时间
接收耗时(4) = 数据接收完成时间 - 接收开始时间4. 错误码说明
| 错误码 | 触发场景 |
|---|---|
612007 | DNS 解析失败。无法将域名解析为 IP 地址 |
699003 | 数据发送失败。sendTo 实际发送字节数与预期不符 |
699004 | 数据接收失败。recvfrom 返回异常 |
699005 | 响应校验失败。接收到的数据不符合 checkType 配置的校验规则 |
5. 配置示例
5.1 基础 UDP 回显测试
5.2 指定响应内容包含校验
5.3 指定响应长度校验
5.4 域名目标
6. 注意事项
1.
2.
HEX: 或 BASE64: 前缀时，需确保后续数据格式正确，否则可能导致测试失败或无数据。3.
checkType 不为 0 时，若校验失败会上报（699005）错误码。4.
content 未配置或为空字符串，拨测流程会在发送阶段前终止，仅产生 DNS。