閱讀307 返回首頁    go 阿裏雲


ossprobe__常用工具_對象存儲 OSS-阿裏雲

簡介

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 Object的Url
  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,如果您使用的是專有雲,請一定要選擇該網絡內可以訪問的地址。
  11. 提示:如果參數中有-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為https://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是否正常。

參考資料

最後更新:2016-11-23 16:04:11

  上一篇:go 如何結合RAM實現文件共享__ossftp_常用工具_對象存儲 OSS-阿裏雲
  下一篇:go Linux平台使用說明__官方遷移工具_常用工具_對象存儲 OSS-阿裏雲