1. 云计算教程网首页
  2. 阿里云

ossprobe

简介

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

版本

版本号:1.0.0

主要功能

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

支持平台

  • linux
  • windows
  • mac

软件下载

  • windows64 ossprobe
  • linux64 ossprobe
  • mac ossprobe

检测下载问题

  • 用法
    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,如果您使用的是专有云,请一定要选择该网络内可以访问的地址。
  • 示例

    检测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

检测上传问题

  • 用法
    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
    说明 随机产生的文件名以ossuploadtmp开头。

平台差异

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

查看报告结果

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

控制台显示

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

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

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

日志文件

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

参考资料

  • oss错误码列表
  • 获取Url的方法

发布者:佚, 佚名,转转请注明出处:https://www.cms2.cn/aliyun/2792.html

发表评论

电子邮件地址不会被公开。 必填项已用*标注

联系我们

400-800-8888

在线咨询:点击这里给我发消息

邮件:admin@example.com

工作时间:周一至周五,9:30-18:30,节假日休息

QR code