| 参数名 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|
host | 是 | - | FTP 服务器域名或 IP |
port | 否 | 21 | FTP 服务端口号 |
user | 否 | anonymous | 登录用户名 |
pwd | 否 | 空 | 登录密码 |
passive | 否 | false | 是否使用被动模式(PASV)。值为 true 时启用 |
url | 是 | - | 要下载的文件路径(FTP 路径) |
| 指标索引 | 指标名称 | 计算方式 |
|---|---|---|
| 0 | 总耗时 | 下载 URL 的耗时(同 5) |
| 1 | DNS 解析时间 | 解析 host 为 IP 的耗时 |
| 2 | 连接时间 | 建立 FTP 控制连接的耗时 |
| 3 | 登录时间 | 从发送用户名密码到登录成功的耗时 |
| 4 | 下载字节数 | 成功下载的文件大小(字节) |
| 5 | 下载时间 | 从发送 GET 到接收完成的耗时 |
| 6 | 下载速度 | 下载字节数 / 下载时间(字节 / 毫秒) |
host / port:决定连接目标。连接失败时设置错误码 612029,INDEX_CONNECT 记录实际尝试耗时。user / pwd:登录凭据。认证失败时设置错误码 612015,INDEX_LOGIN 记录尝试耗时。passive:false(默认):使用主动模式,服务器主动连接客户端数据端口,可能受客户端防火墙影响。true:使用被动模式,客户端连接服务器开放的数据端口,穿透性更好。url:指定下载文件路径。若文件不存在或权限不足,会触发异常并设置错误码 699000;如果未配置 URL,会导致总耗时(性能)为 0。| 错误码 | 含义 |
|---|---|
| 612007 | DNS 解析失败 |
| 612029 | FTP 连接失败 |
| 612015 | 登录失败(用户名或密码错误) |
| 699000 | 文件下载异常 |