全部产品
对象存储 OSS

ossprobe

更新时间:2017-06-13 11:34:40   分享:   

简介

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

版本

版本号:1.0.0

主要功能

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

支持平台

  • linux
  • windows
  • mac

软件下载

检测下载问题

用法

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

说明: 如果参数中有-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

说明:

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

检测上传问题

用法

  1. ossprobe --upload -i AccessKeyId -k AccessKeySecret -p EndPoint -b BucketName [-m normal|append|multipart]
  2. [-s UploadFilePath] [-o ObjectName] [-a Addr]
  3. -i --id AccessKeyID
  4. -k --key AccessKeySecret
  5. -p --endpoint EndPoint
  6. -b --bucket BucketName
  7. -s --src 待上传文件路径,默认为本地临时文件的路径。
  8. -m --mode 文件上传方式,默认为normal上传。
  9. -o --object 上传后的object名称,当-s非空,默认值为上传文件名。当-s为空,默认值为以tem开头的临时文件的文件名。
  10. -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

说明: 随机产生的文件名以ossuploadtmp开头。

平台差异

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

    win平台差异
  • linux&mac打开终端,在弹出的终端界面中,输入该工具的所在的路径,然后填入相关检测参数后即可执行。
    lin平台差异

查看报告结果

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

控制台显示

控制台显示的主要内容有:

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

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

日志文件

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

参考资料

本文导读目录
本文导读目录
以上内容是否对您有帮助?