BOS Probe

概述

当用户在使用百度智能云BOS上传或下载遇到问题时,可以使用BOSProbe 工具进行自我检测。

BOSPorbe 工具能够自动检测用户的上传和下载,并收集用户当前网络和命令执行的相关信息,最后形成一份可读的问题报告和错误处理建议。用户借助问题报告和错误处理建议可以简单、快速的排查出导致BOS上传下载出现问题的原因。用户在无法确认问题原因时,也可以将此报告通过提交工单发方式,发送给百度智能云客服,我们会帮助用户快速准确地排查出引起问题的根本原因,节省用户的时间。

安装BOSProbe

BOSProbe 是 bcecmd 的子命令,如果您已经安装了 bcecmd 就无需再安装 BOSProbe, 如果您还没有安装 bcecmd 您可以按如下方法安装 bcecmd:

  1. 进入bcecmd下载页面, 地址链接: bcecmd

  2. 请根据自己的操作系统类型,下载对应版本的bcecmd,下载完成后只需解压zip包到您需要执行程序的目录,无需安装,您可以直接在终端中使用。

说明:

  • Linux 用户解压命令为 $ unzip linux-bcecmd-0.1.zip;
  • Mac 用户解压命令为 $ unzip mac-bcecmd-0.1.zip;
  • 建议您将 bcecmd 所在目录加入操作系统的环境变量中,这样您在任何目录下都能够运行 bcecmd;
  • windows用户请在cmd中运行程序, linux用户请在终端中运行程序。

通过BOSProbe检查上传下载

bcecmd 使用多层命令结构, 所有命令都以 bcecmd 开头,您可以用如下命令来使用 BOSProbe 提供的上传和下载检测功能:

$ bcecmd bosprobe <command> [options]

参数解释

参数项 取值 说明
command 取值为:uploaddownload 各命令的作用请参见命令功能描述。
+options BOSProbe命令的 Option,取值为-a-s-b等。 upload 和 download 可配置的option不一样,详细的使用方法请参见各命令行解释。

命令输出

  • 网络检测结果;
  • 上传检测结果;
  • 错误信息;
  • 建议;
  • 检测报告保存地址。

上传检测

描述: 上传检测用于检测和收集上传过程中遇到的错误和收集网络信息,并生成报告和错误信息提示。上传的文件可以是BOSProbe生成的一个大小为1M的随机文件,也可以是您手动指定的随意大小的文件。

命令格式:

bcecmd bosprobe upload -b <bucket> [-a <ak>] [-s <sk>] [-f local-path] [-o object] [-e endpoint]

说明:

  • -b 上传到指定的bucket (必需指定);
  • -a 您使用的AK (bucket 为公共写时无需指定,非必需);
  • -s 您使用的SK (bucket 为公共写时无需指定,非必需);
  • -f 要上传的文档的路径, 如果为空,bosprobe则随机生成的文件;
  • -o 指定上传的文件在bucket中存储的名称,如果为空,则为本地文件名;
  • -e endpoint, 如果您指定了endpoint, 则上传数据到此endpoint 如果没指定,则根据bucket name推导出endpoint。

注意:

  • 如果Bucket不是公共读写,执行命令时请指定AK/SK。

示例:

  • 1. 随机生成文件上传到指定endpoint

    操作示例: bcecmd bosprobe upload –a 123 –s 456 –b mybucket -e su.bcebos.com

  • 2. 随机生成文件上传到指定ip

    操作示例: bcecmd bosprobe upload -a 123 -s 456 -b mybucket -e 123.234.1.233

  • 3. 上传指定文件

    操作示例: bcecmd bosprobe upload –a 123 –s 456 –b mybucket –f ./file -o filename -e su.bcebos.com

检测结果示例

  • 1.上传成功

    网络检测中.... [网络良好]
    上传检测中.... [上传成功]
    
    ************************* 上传 **************************
    OBJECT NAME:    probe20171219210323660.temp
    FILE SIZE  :    1048576
    USED TIME  :    316 ms
    SPEED      :    3.16 MB/s
    
    ************************* 建    议 **************************
    测试通过
    
    如果提示没能解决问题,您也可以在百度智能云的管理控制台创建工单,将BOSProbe生成的日志文件(如果未能够生成日志文件,
    请将BosProbe的所有输出信息复制到本地文件)反馈给我们,我们会尽快处理!
    
    此次测试的日志保存于: /home/xxxx/bosprobe2017-xx-xx_xx_xx_xx_89568.log
    
  • 2.上传失败

    网络检测中.... [网络良好]
    上传检测中.... [上传失败]
    
    ************************* 错误信息 **************************
    ERROR CODE: NoSuchBucket
    ERROR MSG : [Code: NoSuchBucket; Message: The specified bucket does not exist.; RequestId: xxx]
    
    ************************* 建    议 **************************
    请检查您指定的 bucket 是否存在,如果存在,请您确认bucket name是否拼写正确、endpoint是否正确!
    
    如果提示没能解决问题,您也可以在百度智能云的管理控制台创建工单,将BOSProbe生成的日志文件(如果未能够生成日志文件,
    请将BosProbe的所有输出信息复制到本地文件)反馈给我们,我们会尽快处理!
    
    此次测试的日志保存于: /home/xxxx/bosprobe2017-xx-xx_xx_xx_xx_9729.log
    

说明:

  • 错误原因不同错误信息和建议会不同;
  • 您可以根据检测结果中的建议来解决上传错误,如果给出的建议不能解决您的问题,您可以在百度智能云的管理控制台创建工单,并将BOSProbe生成的报告文件(如果未能够生成报告文件,请将BosProbe的所有输出信息复制到本地文件)反馈给我们,我们会尽快处理!

下载检测

描述:

下载检测用于检测和收集下载过程中遇到的错误和网络信息。下载检测时,您可以指定要下载的 object 名, 也可以不指定(如果不指定,BOSProbe将选择bucket中的第一个 object 用于下载测试)。

命令格式:

bcecmd bosprobe download [-a <ak>] [-s <sk>] [-f url] [-b bucket] [-o object] [-t to] [-e endpoint]

说明:

  • -a 当前操作用户AK (bucket 为公共写和使用url下载测试时无需指定,非必需);
  • -s 当前操作用户SK (bucket 为公共写和使用url下载测试时无需指定,非必需);
  • -f object的url, 测试url下载时为必需;
  • -b 要下载的文件所在的Bucket (测试url下载测试时非必需,非url下载测试时必需);
  • -o 要下载的object的名称 (非必需);
  • -t 文件保存的local地址 (非必需);
  • -e endpoint (非必需)。

注意:

  • 不能即指定url又指定bucket 或object, 即 -f 不能与 -b -o 同时使用;
  • 测试url下载时不需要指定 endpoint, 即 -e 不能与 -f一起使用。

示例:

  • 1. url下载测试

    操作示例:bcecmd bosprobe download -f http://bj.bcebos.com/mybucket/file1.txt
    操作示例:bcecmd bosprobe download –f http://bj.bcebos.com/mybucket/file1.txt -t ./tmp/example.txt`

  • 2. 从指定bucket随机下载测试

    操作示例: bcecmd bosprobe download –a 123 –s 456 –b mybucket

  • 3. 下载指定object

    操作示例: bcecmd bosprobe download –a 123 –s 456 –b mybucket –o file1.txt

  • 4.下载指定object到本地指定位

    操作示例: bcecmd bosprobe download –a 123 –s 456 –b mybucket –o file1.txt –t ./tmp/example.txt

检测结果示例

  • 1.下载成功

    网络检测中.... [网络良好]
    下载检测中.... [下载成功]
    
    ************************* 下载 **************************
        OBJECT NAME:    file1.txt
        FILE SIZE  :    555
        USED TIME  :    144 ms
        SPEED      :    0.00 MB/s
    
    ************************* 建    议 **************************
    测试通过
    
    如果提示没能解决问题,您也可以在百度智能云的管理控制台创建工单,将BOSProbe生成的日志文件(如果未能够生成日志文件,
    请将BosProbe的所有输出信息复制到本地文件)反馈给我们,我们会尽快处理!
    
    此次测试的日志保存于: /home/xxxx/bosprobe2017-xx-xx_xx_xx_xx_84579.log
    
  • 2.下载失败

    网络检测中.... [网络良好]
    下载检测中.... [下载失败]
    
    ************************* 错误信息 **************************
        ERROR CODE: NoSuchKey
        ERROR MSG : [Code: NoSuchKey; Message: The specified key does not exist.; RequestId: xxx]
    
    ************************* 建    议 **************************
    您指定的object在BOS中不存在, 请您检查object name是否拼写正确! 如果指定的 object key 为目录, 
    请给object key 加上后缀 "/"。
    
    如果提示没能解决问题,您也可以在百度智能云的管理控制台创建工单,将BOSProbe生成的日志文件(如果未能够生成日志文件,
    请将BosProbe的所有输出信息复制到本地文件)反馈给我们,我们会尽快处理!
    
    此次测试的日志保存于: /home/xxxx/bosprobe2017-xx-xx_xx_xx_xx_86018.log
    

建议及报告查看

检测执行完成后会在控制台显示检测结果并生成测试报告(即测试日志)。

检测结果:

测试结果包含错误信息、建议和测试报告存放的地址。

测试报告:

测试报告包含网络测试结果、上传下载测试结果、错误信息、建议和调试信息。

说明:

您可以根据测试结果中给出的建议来解决上传下载中出现的错误。如果给出的建议不能解决您的问题,您可以在百度智能云的管理控制台创建工单,并将BOSProbe生成的测试报告(如果未能够生成测试报告,请将BosProbe的所有输出信息复制到本地文件)作为工单的附件上传给我们,我们会尽快处理!