何为ossprobe?-问答-阿里云开发者社区-阿里云

开发者社区> 问答> 正文

何为ossprobe?

青衫无名 2017-10-23 13:57:24 2049


简介


ossprobe是一款针对oss访问的检测工具,用于排查上传下载过程中,因网络故障或基本参数设置错误导致的问题。用户执行上传下载命令后,ossprobe会提示可能的错误原因,帮助用户快速找出错误。

版本


版本号:1.0.0

主要功能

  • 检测网络环境是否正常
  • 检查基本参数是否正常
  • 测试基本上传下载速度


支持平台

  • linux
  • windows
  • mac


软件下载



检测下载问题



用法ossprobe --download  [-i AccessKeyId] [-k AccessKeySecret] [-p EndPoint] [-b BucketName] [-o ObjectName] [-t LocalPath]  
        [-f Url] [-a Address]
    -f   --from       Object的Url
    -i   --id         AccessKeyId
    -k   --key        AccessKeySecret
    -p   --endpoint   EndPoint
    -b   --bucket     BucketName
    -o   --object     ObjectName
    -t   --to         保存下载内容的文件路径,默认为当前目录下的临时文件的路径。
    -a   --addr       检测的网络地址,默认的地址为www.aliyun.com,如果您使用的是专有云,请一定要选择该网络内可以访问的地址。




[backcolor=transparent]说明: 如果参数中有-f,使用Url下载。如果没有-f,必须指定AccessKeyID、AccessKeySecret、EndPoint、BucketName四个参数。


示例


检测Url下载是否正常( 获取Url的方法),可以使用下面的命令:
方式命令
从指定Url下载ossprobe --download -f Url
从指定Url下载到指定文件ossprobe --download -f Url -t tmp/example.txt
从指定Url下载、并检测指定地址网络状况ossprobe --download -f Url -a Addr

检测指定参数(AccessKeyID, AccessKeySecret, EndPoint, BucketName)下载是否正常,可以通过以下命令检测:
方式命令
下载随机文件ossprobe --download -i AccessKeyId -k AccessKeySecret -p EndPoint -b BucketName
下载指定的文件ossprobe --download -i AccessKeyId -k AccessKeySecret -p EndPoint -b BucketName -o ObjectName
下载指定的文件并保存到本地指定文件ossprobe --download -i AccessKeyId -k AccessKeySecret -p EndPoint -b BucketName -o ObjectName -t tmp/example.txt
下载随机文件、并检测指定地址网络状况ossprobe --download -i AccessKeyId -k AccessKeySecret -p EndPoint -b BucketName -a Addr

[backcolor=transparent]说明:
  • 用户下载的是二进制可执行程序,在linux上需要通过chmod +x ossprobe添加ossprobe的可执行权限。
  • -t的参数的默认值是当前目录下的一个临时文件的路径(文件名格式为:ossfilestore20160315060101)。
  • 如果-t的参数值为一个目录,那么就在该目录产生一个临时文件(文件名格式为:ossfilestore20160315060101),用于保存数据。
  • 采用Url下载时,保存文件名取Url中以“/”分割之后最后的一个字符串,比如说Url为,文件名就是a.jpg。


检测上传问题



用法ossprobe --upload -i AccessKeyId -k AccessKeySecret -p EndPoint  -b BucketName [-m normal|append|multipart]  
        [-s UploadFilePath] [-o ObjectName] [-a Addr]
    -i    --id        AccessKeyID
    -k    --key       AccessKeySecret
    -p    --endpoint  EndPoint
    -b    --bucket    BucketName
    -s    --src       待上传文件路径,默认为本地临时文件的路径。
    -m    --mode      文件上传方式,默认为normal上传。
    -o    --object    上传后的object名称,当-s非空,默认值为上传文件名。当-s为空,默认值为以tem开头的临时文件的文件名。
    -a    --addr      检测的网络地址,默认为阿里云的官网地址,如果您使用的是专有云,请一定要选择该网络内可以访问的地址。





示例

方式命令
生成临时文件,并采用normal方式上传ossprobe --upload -i AccessKeyId -k AccessKeySecret -p EndPoint -b BucketName
生成临时文件,并采用append方式上传ossprobe --upload -i AccessKeyId -k AccessKeySecret -p EndPoint -b BucketName -o ObjectName -m append
生成临时文件,并采用multipart方式上传ossprobe --upload -i AccessKeyId -k AccessKeySecret -p EndPoint -b BucketName -o ObjectName -m multipart
采用multipart上传方式,上传指定的内容ossprobe --upload -i AccessKeyId -k AccessKeySecret -p EndPoint -b BucketName -o ObjectName -m multipart -s src
采用multipart上传指定的内容,并给出Object名称ossprobe --upload -i AccessKeyId -k AccessKeySecret -p EndPoint -b BucketName -m multipart -s src -o example.txt
生成临时文件,采用normal方式上传,并检测指定地址网络状况ossprobe --upload -i AccessKeyId -k AccessKeySecret -p EndPoint -b BucketName -a Addr

[backcolor=transparent]说明: 随机产生的文件名以ossuploadtmp开头。


平台差异


  • windows按下Win + R调出运行对话框,输入命令cmd并按回车执行。 在弹出的命令行终端界面中,输入该工具的所在的路径,然后填入相关检测参数后即可执行。
  • linux&mac打开终端,在弹出的终端界面中,输入该工具的所在的路径,然后填入相关检测参数后即可执行。


查看报告结果


命令运行结束时,生成一个文件名为logOssProbe20060102150405.txt(logOssProbe后面的数字为当前时间的格式化输出)的报告文件。可能的错误原因会在命令行打印。如果错误提示不够具体,用户可以查看报告进行排查问题。如果还是无法解决,您也可以在工单里附上检测报告。

控制台显示


控制台显示的主要内容有:
  • 执行步骤后出现×表示没有通过,否则表示通过。
  • 结果显示整个上传下载成功还是失败。当成功时,会给出文件的大小和上传下载时间。
  • 修改建议项提示导致错误的原因,或直接给出修改建议。
  • 用户如果对oss错误码比较了解,也可以通过oss返回的详细的错误信息进行排查。
  • 日志信息提示日志名称和日志的地址,方便用户查找具体的日志。

[backcolor=transparent]说明: 并不是每次错误的检测都能提示出修改建议,对于没有提示修改建议的检测,请根据错误码提示,并结合 oss错误码ErrorCode进行问题排查。


日志文件


日志文件不同于控制台显示主要是可以查看详细的网络检测过程,ping可以查看到指定的网络是否正常,可以查看到指定的EndPoint的网络是否正常,tracert可以查看到访问EndPoint的路由情况,最后一个nslookup可以查看DNS是否正常。

参考资料

网络协议 专有云 Linux 对象存储 Windows
分享到
取消 提交回答
全部回答(0)
云计算
使用钉钉扫一扫加入圈子
+ 订阅

时时分享云计算技术内容,助您降低 IT 成本,提升运维效率,使您更专注于核心业务创新。

推荐文章
相似问题
推荐课程