すべてのプロダクト
Search
ドキュメントセンター

:ossprobe

最終更新日:Dec 22, 2023

はじめに

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" として保存されます。

アップロードの問題の検出

  • 使用方法
    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 検出に使用されます。

参考資料