307
阿裏雲
ossprobe__常用工具_對象存儲 OSS-阿裏雲
簡介
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,如果您使用的是專有雲,請一定要選擇該網絡內可以訪問的地址。
提示:如果參數中有-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。
檢測上傳問題
用法
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並按回車執行。 在彈出的命令行終端界麵中,輸入該工具的所在的路徑,然後填入相關檢測參數後即可執行。
- linux&mac打開終端,在彈出的終端界麵中,輸入該工具的所在的路徑,然後填入相關檢測參數後即可執行。
查看報告結果
命令運行結束時,生成一個文件名為logOssProbe20060102150405.txt(logOssProbe後麵的數字為當前時間的格式化輸出)的報告文件。可能的錯誤原因會在命令行打印。如果錯誤提示不夠具體,用戶可以查看報告進行排查問題。如果還是無法解決,您也可以在工單裏附上檢測報告。
控製台顯示
控製台顯示的主要內容有:
- 執行步驟後出現×表示沒有通過,否則表示通過。
- 結果顯示整個上傳下載成功還是失敗。當成功時,會給出文件的大小和上傳下載時間。
- 修改建議項提示導致錯誤的原因,或直接給出修改建議。
- 用戶如果對oss錯誤碼比較了解,也可以通過oss返回的詳細的錯誤信息進行排查。
- 日誌信息提示日誌名稱和日誌的地址,方便用戶查找具體的日誌。
(提示:並不是每次錯誤的檢測都能提示出修改建議,對於沒有提示修改建議的檢測,請根據錯誤碼提示,並結合oss錯誤碼ErrorCode
進行問題排查)
日誌文件
日誌文件不同於控製台顯示主要是可以查看詳細的網絡檢測過程,ping可以查看到指定的網絡是否正常,可以查看到指定的EndPoint的網絡是否正常,tracert可以查看到訪問EndPoint的路由情況,最後一個nslookup可以查看DNS是否正常。
參考資料
最後更新:2016-11-23 16:04:11
上一篇:
如何結合RAM實現文件共享__ossftp_常用工具_對象存儲 OSS-阿裏雲
下一篇:
Linux平台使用說明__官方遷移工具_常用工具_對象存儲 OSS-阿裏雲
可信源___產品功能說明_產品常見問題_DDoS 高防IP-阿裏雲
禁止數據導出__應用場景_產品簡介_數據管理-阿裏雲
Pig 開發手冊__Hadoop_開發人員指南_E-MapReduce-阿裏雲
ECS上的自建數據庫到RDS/MongoDB/PetaData/OceanBase的數據遷移__數據遷移_用戶指南_數據傳輸-阿裏雲
UpdateMachineGroup__Logtail機器組相關接口_API-Reference_日誌服務-阿裏雲
服務等級協議__產品簡介_消息服務-阿裏雲
MaxCompute數據源配置__數據源配置_數據同步手冊_用戶操作指南_大數據開發套件-阿裏雲
商品相關性分析__最佳實踐_雲數據庫 Redis 版-阿裏雲
聚合函數__函數_SQL語法參考_雲數據庫 OceanBase-阿裏雲
刪除伸縮組__伸縮組_用戶指南_彈性伸縮-阿裏雲
相關內容
常見錯誤說明__附錄_大數據計算服務-阿裏雲
發送短信接口__API使用手冊_短信服務-阿裏雲
接口文檔__Android_安全組件教程_移動安全-阿裏雲
運營商錯誤碼(聯通)__常見問題_短信服務-阿裏雲
設置短信模板__使用手冊_短信服務-阿裏雲
OSS 權限問題及排查__常見錯誤及排除_最佳實踐_對象存儲 OSS-阿裏雲
消息通知__操作指南_批量計算-阿裏雲
設備端快速接入(MQTT)__快速開始_阿裏雲物聯網套件-阿裏雲
查詢API調用流量數據__API管理相關接口_API_API 網關-阿裏雲
使用STS訪問__JavaScript-SDK_SDK 參考_對象存儲 OSS-阿裏雲