はじめに
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 Save path for the downloaded content. By default, it is the path to a temporary file in the current directory. -a --addr Network address for detection. The default address is www.aliyun.com. If you are using private cloud, select an accessible address in the private cloud. TIP: If the -f parameter is present, a URL is used for download. If the -f parameter is not present, you must set the AccessKeyID, AccessKeySecret, EndPoint, and BucketName parameters.
- 例
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 ossprobee
を介して ossprobe の実行可能な権限を追加する必要があります。 - 既定では、-t パラメーターは現在のディレクトリ内の一時ファイルへのパスを示します (ファイル名の形式は ossfilestore20160315060101 です)。
- -t パラメーターがディレクトリを示す場合、データを保存するため、一時ファイルがそのディレクトリ内に生成されます (ファイル名の形式は ossfilestore20160315060101 です)。
- ファイルが URL からダウンロードされる場合、 ファイル名は URL 内のスラッシュ "/" に続く末尾の文字列になります。 たとえば、 URL が
http://aliyun.com/a.jpg
の場合、 ファイル名は "a.jpg" として保存されます。
- ダウンロードしたファイルは、バイナリ形式の実行プログラムです。 Linux システムで
アップロードの問題の検出
- 使用方法
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 Path to the file you want to upload. By default, it is the path to a local temporary file. -m --mode File upload mode. The default is normal upload. -o --object Uploaded object name. By default, the object name is the name of the uploaded file if -s is not null. If -s is null, by default, the object name is the name of the temporary file starting with tem. -a --addr Network address for detection. The default address is the address of the Alibaba Cloud website. If you are using private cloud, select an accessible address in the private cloud.
- 例
方法 コマンド 一時ファイルを生成し、通常モードでアップロード ossprobe --upload -i AccessKeyId -k AccessKeySecret -p EndPoint -b BucketName
一時ファイルを生成し、追加モードでアップロード ossprobe --upload -i AccessKeyId -k AccessKeySecret -p EndPoint -b BucketName -o ObjectName -m append
一時ファイルを生成し、マルチパートモードでアップロード ossprobe --upload -i AccessKeyId -k AccessKeySecret -p EndPoint -b BucketName -o ObjectName -m multipart
マルチパートモードにより、指定したコンテンツをアップロード ossprobe --upload -i AccessKeyId -k AccessKeySecret -p EndPoint -b BucketName -o ObjectName -m multipart -s src
マルチパートモードにより、指定したコンテンツをアップロードし、オブジェクト名を指定 ossprobe --upload -i AccessKeyId -k AccessKeySecret -p EndPoint -b BucketName -m multipart -s src -o example.txt
一時ファイルを生成し、通常モードでアップロードして、指定したアドレスのネットワーク状態を検出 ossprobe --upload -i AccessKeyId -k AccessKeySecret -p EndPoint -b BucketName -a Addr
説明 ランダムに生成されるファイルの名前は ossuploadtmp で始まります。
プラットフォームによる違い
- Windows の場合、Win + R を押し、 [ファイル名を指定して実行] ダイアログボックスを表示させ、"cmd" と入力して Enter キーを押します。 CLI (コマンドラインインターフェイス) で、ツールへのパスを入力し、関連する検出パラメーターを入力してツールを実行します。
- Linux および Mac の場合は、ターミナルを開きます。 表示されたインターフェイスで、ツールへのパスを入力し、関連する検出パラメーターを入力してツールを実行します。
レポートデータの表示
コマンドの実行後、logOssProbe20060102150405.txt という名前のレポートが生成されます。 (logOssProbe に続く数字は、 レポートが生成された日付を示します)。 考えられるエラーの原因は、コマンドラインモードで表示されます。 エラーメッセージが具体的ではないと思われる場合は、 レポートを表示することが可能です。 問題が解決しない場合は、 検出レポートを添付したチケットを起票します。
- コンソールの表示
コンソールでは、次の主要な情報が表示されます。
- 実行後、× 印の付いたステップは失敗しますが、 × 印のないステップは成功しています。
- 表示される結果は、アップロード操作またはダウンロード操作が 成功したかどうかを示します。 アップロードまたはダウンロード操作が成功すると、 コンソールにファイルサイズおよびアップロードとダウンロードを行った時間が表示されます。
- [Suggested Change] 欄に、エラーの原因または変更の 提案が表示されます。
- ユーザーが OSS エラーコードに詳しい場合は、OSS から返されたエラーメッセージに基づき、 トラブルシューティングを実行できます。
- [Log Info] 欄には、ログ名とアドレスが表示されるので、 ログを見つけることができます。
説明エラーが検出されたときに、変更提案が表示 されないことがあります。 この場合は、 「OSS のエラーコード」を参照して、返されたエラーコードに基づき、トラブルシューティングを行ってください。
- ログファイル
コンソール表示とは異なり、ログファイルにはネットワーク検出の詳細が含まれています。 details. ping は指定したネットワーク、または指定した EndPoint のネットワークを検出するために使用されます。tracert は EndPoint にアクセス経路を検出するために使用され、nslookup は DNS 検出に使用されます。