TCP Send 插件配置说明
一、概述
CONFIG_XXX）及其对监测结果指标计算的影响。所有配置以 key=value 的文本形式传入，每行一个配置项。二、配置选项说明
2.1 基础连接配置
| 配置项 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|
host | 是 | — | 监测目标的域名或 IP 地址。支持 IPv4 和 IPv6 地址。 |
port | 否 | 80 | 监测目标的端口号。 |
ipVersion | 否 | ipv4 | IP 协议版本。可选值：ipv4、ipv6。 名字必须是 ipVersion |
影响说明
host 为空时，任务直接报错退出（错误码 699000）。2.2 数据发送配置
| 配置项 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|
content | 否 | — | 向服务器发送的原始数据。支持以 hex: 开头的十六进制字符串（例如 hex:474554202f...），将自动解码为二进制后发送。 |
影响说明
content 为空或不存在时，插件仅建立连接。40960 字节时会被截断至该上限。2.3 响应接收与校验配置
| 配置项 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|
recv | 否 | — | 对服务器响应进行校验的规则。 • 以 hex: 开头时，表示包含校验：响应内容需包含该十六进制解码后的字节序列。• 否则，视为正则表达式：响应内容需匹配该正则，且不区分大小写。 |
wait | 否 | 0 | 等待接收服务器响应的最大时间，单位毫秒（ms）。 • 0 表示不等待接收响应；如果 wait 未配置或小 1,但配置了 recv，采用 5000 ms。• 实际生效值不超过 任务超时 配置。 |
影响说明
recv 和 wait 至少配置一项，否则不等待接收数据！！！ **recv 校验失败会设置错误码 699003（检验数据失败）；正则表达式异常会设置错误码 699004。wait 决定接收数据阶段的最大等待时长，影响**首包时间（first）和剩余包时间（remain）**的采集完整性。若超时未收到数据，对应指标可能为 0 或缺失。三、结果指标说明
| 指标索引 | 指标名称 | 采集阶段 | 计算方式 | 受影响的配置项 |
|---|---|---|---|---|
0 | 任务总时间（total） | 全局 | 任务结束时刻 - 任务开始时刻 | 任务超时（超时上限）、wait（接收等待） |
1 | DNS 解析时间（dns） | 解析域名 | DNS 解析结束时刻 - DNS 解析开始时刻 | host、ipversion |
2 | 建立连接时间（connect） | TCP 握手 | connect 返回时刻 - connect 开始时刻 | host、port、ipversion、任务超时、 |
3 | 发送数据时间（send） | 发送数据 | send 返回时刻 - 发送开始时刻 | content、任务超时 |
4 | 首包时间（first） | 接收数据 | 首次收到数据的时刻 - 发送结束时刻 | wait、recv、任务超时 |
5 | 剩余包时间（remain） | 接收数据 | 最后一次收到数据的时刻 - 首次收到数据的时刻 | wait、recv、任务超时 |
3.1 指标计算细节
1.
host 已是 IP 地址，则跳过 DNS 解析，指标值为 0。2.
connect 系统调用全过程。3.
699002，指标仍记录已耗时间。4.
recv 返回的时间。0。5.
0。四、错误码说明
| 错误码 | 含义 | 触发场景 |
|---|---|---|
699000 | 基础 / 协议错误 | host 为空、未捕获的异常等。 |
612029 | 连接错误 | TCP connect 失败 |
699002 | 发送数据失败 | 实际发送字节数小于预期。 |
699003 | 检验数据失败 | recv 配置的包含校验或正则匹配未通过。 |
699004 | 检验数据时发生异常 | 正则表达式语法错误或其他异常。 |
612007 | 域名解析失败 | ERROR_INTERNET_NAME_NOT_RESOLVED，DNS 无法解析 host。 |
五、配置示例
5.1 TCP 基础监测（HTTP 请求）
host=www.example.com
port=80
content=hex:474554202f20485454502f312e310d0a0d0a
recv=HTTP/1\.1\s+200
wait=5000www.example.com:80 发送一个 HTTP GET 请求，等待最多 5 秒，校验响应是否包含 HTTP/1.1 200。5.2 TCP 端口连通性监测（无发送、无校验）
host=192.168.1.1
port=4435.3 IPv6 监测
host=2403:a200:a200:13f1::1
port=80
ipversion=ipv6
wait=5000六、注意事项
1.
host、HOST、Host）不区分大小写。2.
# 开头的注释行或空行，会被插件自动忽略。3.
hex: 后的字符串应为连续十六进制字符（如 hex:48656c6c6f），不区分大小写。4.
recv 为非 hex: 时采用正则匹配，默认区分大小写。5.
40960 字节，超过部分将被截断。