| 参数名 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|
host | 是 | - | 目标主机域名或 IP |
port | 是 | - | 目标端口号 |
content | 否 | 空 | 要发送的数据内容。支持 hex: 前缀发送二进制数据 |
timeout | 否 | 22000 | 整体超时时间,单位毫秒 |
wait | 否 | 5000 | 接收数据时的等待超时,单位毫秒 |
recv | 否 | 空 | 期望接收到的响应内容标识。若为空则不等待响应 |
ipVersion | 否 | 空 | IP 版本:ipv4 强制 IPv4,ipv6 强制 IPv6,名字必须是 ipVersion |
protocol | 否 | TCP | 传输协议:TCP 或 UDP |
debug | 否 | false | 是否启用调试日志 |
| 指标索引 | 指标名称 | 计算方式 |
|---|---|---|
| 0 | 总耗时 | 从任务开始到接收完成或超时的总耗时 |
| 1 | DNS 时间 | 域名解析为 IP 的耗时 |
| 2 | 连接时间 | TCP 三次握手耗时(UDP 模式下为 0) |
| 3 | 发送时间 | 调用 send / sendto 到返回的耗时 |
| 4 | 首包时间 | 从发送完成到收到第一笔响应数据的耗时 |
| 5 | 剩余包时间 | 从首包到接收完成(连接关闭或超时)的耗时 |
protocol:TCP(默认):建立连接后发送数据,产出 DNS、连接、发送、首包、剩余包全量指标。UDP:无连接建立过程,指标 2(连接时间)为 0。content:决定发送的数据内容。支持 hex:303132 格式直接发送十六进制数据。若为空,则不发送数据,直接等待接收。wait:接收阶段的 socket 超时(SO_RCVTIMEO)。若 recv 未配置且 wait 为 0,则跳过接收阶段,首包和剩余包指标为 0。recv:配置后插件会 在接收数据中查找匹配内容,用于简单协议校验。host / port:若 host 为域名,先执行 DNS 解析,产出指标 1;若为 IP,则 DNS 时间为 0。| 错误码 | 含义 |
|---|---|
| 699000 | 基础错误 / 异常 |
| 699001 | 连接失败 |
| 699002 | 数据发送失败 |
| 699003 | 数据校验失败 |
| 699004 | 数据校验异常 |
| 699005 | 接收数据失败 |