probe
probe命令是针对OSS访问的检测命令,可用于排查上传、下载过程中因网络故障或基本参数设置错误导致的问题。
命令格式
- 下载http_url地址到本地,并输出探测报告
./ossutil probe --download --url http_url [--addr=domain_name] [file_name]
通过文件URL将存储空间内的一个文件下载到本地来测试网络传输质量,并输出探测报告。- --url:填写指定Bucket内文件的URL地址。
- 公共读文件:直接输入文件URL,例如:
https://bucketname.oss-cn-beijing.aliyuncs.com/myphoto.jpg
。 - 私有文件:输入带签名的文件URL,并且在URL前后需加双引号(“”)。例如:
“https://bucketname.oss-cn-beijing.aliyuncs.com/myphoto.jpg?Expires=1552015472&OSSAccessKeyId=TMP.xxxxxxxx5r9f1FV12y8_Qis6LUVmvoSCUSs7aboCCHtydQ0axN32Sn-UvyY3AAAwLAIUarYNLcO87AKMEcE5O3AxxxxxxoCFAQuRdZYyVFyqOW8QkGAN-bamUiQ&Signature=bIa4llbMbldrl7rwckr%2FXXvTtxw%3D”
。
说明 如何获取文件URL请参见获取URL。 - 公共读文件:直接输入文件URL,例如:
- --addr=domain_name(可选):可在下载文件时同时向一个指定的域名或IP地址发起ping操作。不添加该选项,ossutil不进行额外的探测操作。
- 增加--addr=选项,但是缺省值的话,默认向
www.aliyun.com
发起ping操作。 - 增加--addr=选项,并指定一个域名或IP,则向指定的地址发起ping操作。
- 增加--addr=选项,但是缺省值的话,默认向
- file_name(可选):为下载的文件指定存储路径。如果不输入file_name,则下载文件保存在当前目录下,文件名由工具自动判断;如果输入file_name,则file_name为文件名或者目录名,下载的文件名为file_name或者保存在file_name目录下。
- --url:填写指定Bucket内文件的URL地址。
- 下载指定Bucket中的Object,并输出探测报告
./ossutil probe --download --bucketname bucket-name [--object=object_name] [--addr=domain_name] [file_name]
- --bucketname:填写Bucket名。
- --object=(可选):填写指定的Object路径可下载指定的Object。例如:path/myphoto.jpg。不指定--object=,则工具会生成一个临时文件上传到bucket-name后再将其下载,下载结束后会将该临时文件从本地和Bucket中删除。
- 上传Object并输出探测报告
./ossutil probe --upload [file_name] --bucketname bucket-name [--object=obj ect_name] [--addr=domain_name] [--upmode]
- file_name(可选): 指定file_name可将指定的文件上传到bucket-name中;不指定file_name,则工具会生成一个临时文件上传到bucket-name中,探测结束后会将临时文件删除。
- --object=(可选):输入文件名或文件路径,可指定Object上传后的名称,例如:path/myphoto.jpg。若不配置--object=,则由工具自动生成上传后的Object名称,探测结束后会将该临时Object删除。
- --upmode(可选):指定上传的方式,缺省该项则使用正常上传。可选值为normal、 append、multipart。
- normal:正常上传
- append:追加上传
- multipart:分片上传
- 其他探测
./ossutil probe --probe-item item_value --bucketname bucket-name [--object=object_name]
--probe-item:指定其他探测的内容,取值为upload-speed、 download-speed、cycle-symlink。- upload-speed:探测上传带宽并输出探测结果。指定该值时,--object=object_name项可不指定。
- download-speed:探测下载带宽并输出探测结果。您需要指定--object=object_name项,且该Object在OSS中已存在。为了测试的准确性,建议Object的大小超过10MB。
- cycle-symlink:探测本地文件目录中是否存在死循环链接文件或者目录。
使用示例
- 下载http_url地址到本地,并输出探测报告
./ossutil probe --download --url https://bucket1.oss-cn-beijing.aliyuncs.com/myphoto.jpg --addr=www.aliyun.com /file/myphoto.jpg
- 下载指定Bucket中的Object,并输出探测报告
./ossutil probe --download --bucketname bucket1 --object=myphoto.jpg --addr=www.aliyun.com /file/myphoto.jpg
- 上传探测并输出探测报告
./ossutil probe --upload /file/myphoto.jpg --bucketname bucket1 --object=myphoto.jpg --upmode normal
- 探测上传带宽并输出探测结果
./ossutil probe --probe-item upload-speed --bucketname bucket1 cpu core count:4 parallel:4,average speed:14231.17(KB/s),current speed:12992.00(KB/s),max speed:23776.00(KB/s) parallel:5,average speed:16871.72(KB/s),current speed:14272.00(KB/s),max speed:22336.00(KB/s) parallel:6,average speed:21072.55(KB/s),current speed:22176.00(KB/s),max speed:25344.00(KB/s) parallel:7,average speed:24622.34(KB/s),current speed:25216.00(KB/s),max speed:31200.00(KB/s) parallel:8,average speed:26388.97(KB/s),current speed:30880.00(KB/s),max speed:30880.00(KB/s) suggest parallel is 8, max average speed is 26388.97(KB/s) 152.834561(s) elapsed
- 探测下载带宽并输出探测结果
./ossutil probe --probe-item download-speed --bucketname bucket1 --object test/1.bmp cpu core count:4 parallel:4,average speed:25925.10(KB/s),current speed:26823.95(KB/s),max speed:30149.93(KB/s) parallel:5,average speed:31565.45(KB/s),current speed:30124.70(KB/s),max speed:37400.07(KB/s) parallel:6,average speed:34793.28(KB/s),current speed:39689.43(KB/s),max speed:40465.45(KB/s) parallel:7,average speed:40403.66(KB/s),current speed:46594.91(KB/s),max speed:46594.91(KB/s) parallel:8,average speed:48459.10(KB/s),current speed:52303.80(KB/s),max speed:54165.61(KB/s) suggest parallel is 8, max average speed is 48459.10(KB/s) 152.724271(s) elapsed
查看探测报告
probe命令运行后,您可以看到任务执行的步骤及结果。
- 执行步骤后出现×表示没有通过,否则表示通过。
- 结果显示整个上传下载成功还是失败。当成功时,会给出文件的大小和上传下载时间;失败时,会给出导致错误的原因,或直接给出修改建议。
说明 并不是每次错误的检测都能提示出修改建议,对于没有提示修改建议的检测,请根据错误码提示,并结合oss错误码ErrorCode进行问题排查。
probe命令执行完毕后,ossutil会在当前目录下生成一个以logOssProbe开头的文件,里面包含此次探测命令执行的详细信息。
常用选项
您可以在使用probe命令时附加如下选项:
选项名称 | 描述 |
---|---|
--url | 表示一个网络地址,ossutil会下载该地址。 |
--bucketname | OSS中Bucket的名称。 |
--object | OSS中Object的名称。 |
--addr | 需要网络探测的域名,工具会对该域名进行ping等操作,默认值为www.aliyun.com 。
|
--upmode | 指定上传的方式,缺省该项则使用正常上传。可选值为:
|
--upload | 表示上传到OSS。 |
--download | 表示从OSS下载。 |
--loglevel | 设置日志级别,默认为空,表示不输出日志文件。可选值为:
|
--proxy-host | 网络代理服务器的url地址,支持http、https、socks5。例如http://120.79.**.**:3128、 socks5://120.79.**.**:1080。 |
--proxy-user | 网络代理服务器的用户名,默认为空。 |
--proxy-pwd | 网络代理服务器的密码,默认为空。 |
--probe-item | 表示probe命令的探测项目,可选值为:
|
说明 更多通用选项请参见查看选项。
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论