このトピックでは、 プローブ コマンドを実行して、ローカルクライアントとObject Storage Service (OSS) 間のネットワーク接続の例外を検出し、アップロード帯域幅とダウンロード帯域幅を確認し、ローカルシンボリックリンクのステータスを取得します。
使用上の注意
アップロード帯域幅を確認するには、
oss:GetObject
、oss:PutObject
、およびoss:DeleteObject
権限が必要です。 ダウンロード帯域幅を確認するには、oss:GetObject
権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。このトピックでは、64ビットLinuxシステムに基づくサンプルコマンドラインを提供します。 他のシステムのために、取り替えて下さい./ossutil64対応するバイナリ名を持つコマンドで 詳細は、「ossutilコマンドリファレンス」をご参照ください。
使用上の注意
probeコマンドを実行して、ローカルクライアントとOSS間のネットワーク接続の例外を検出し、アップロード帯域幅とダウンロード帯域幅を確認できます。 このコマンドを実行して、多数のシンボリックリンクのステータスをアップロードする前に確認することもできます。
ネットワーク例外の検出
ossutilは、オブジェクトをアップロードまたはダウンロードして、ローカルクライアントとOSS間のネットワーク接続のステータスを確認します。 ネットワーク例外を検出したときに指定した場所にオブジェクトをアップロードまたはダウンロードするには、実際のオブジェクトの名前を指定することを推奨します。 ネットワーク例外を検出するだけでよい場合は、オブジェクト名を指定せずにコマンドを実行します。 ossutilは、接続検出用の一時オブジェクトを生成し、接続検出の完了後にオブジェクトを削除します。
アップロードとダウンロード帯域幅の確認
このコマンドを実行してアップロードとダウンロードの帯域幅を確認すると、OSSはローカルデバイスのCPUとネットワーク帯域幅に基づいて、アップロードとダウンロードの同時タスクの推奨数を提供します。 推奨される同時タスク数を使用して、ネットワーク帯域幅の使用量を最大化できます。
ローカルシンボリックリンクのステータスを確認する
多数のシンボリックリンクをアップロードする場合、リンクの1つに異常が発生すると、アップロードが中断されます。 ローカルシンボリックリンクのステータスをアップロードする前に確認することを推奨します。 シンボリックリンクの1つに異常がある場合は、リンクをアップロードする前に問題を修正してください。
probeコマンドを実行した後、各アップロードまたはダウンロードタスクの手順と結果を表示できます。
オブジェクトのアップロードまたはダウンロードによるネットワーク例外の検出
チェックマーク (√) は、チェック結果が正であることを示す。 × 印は、チェック結果が否定的であることを示す。
検出が成功すると、アップロードまたはダウンロードされたオブジェクトのサイズ、アップロードまたはダウンロードタスクの実行に使用された時間、オブジェクトがアップロードまたはダウンロードされた場所など、アップロードまたはダウンロードタスクに関する情報が返されます。
検出に失敗した場合、ossutilはエラーの原因またはエラーコードを返します。これはエラーのトラブルシューティングに使用できます。
エラーコードの詳細については、「概要」をご参照ください。
検出が完了すると、ossutilはインストール場所に
logOssProbe + DetectionCompletionTime.log
という形式のログファイルを作成します。 ログファイルには、probeコマンドに関する詳細情報が含まれています。
特定のアイテムを確認する
probeコマンドを実行してアップロードとダウンロードの帯域幅、またはローカルのシンボリックリンクのステータスを確認すると、チェック結果と提案が表示されます。
オブジェクトをアップロードしてネットワーク接続ステータスを確認し、レポートを生成する
ossutilは、オブジェクトをバケットにアップロードして、ローカルクライアントとバケット間のネットワーク接続ステータスをチェックします。
コマンド構文
./ossutil64 probe {-- upload [file_name]} {-- bucketname bucket_name} [-- object object_name] [-- addr domain_name] [-- upmode]
次の表に、上記のコマンドのパラメーターを示します。
パラメーター
必須
説明
-- upload
可
アップロードを実行して接続検出を実行することを指定します。
file_name
任意
バケットにアップロードするローカルファイルのフルパス。 このパラメーターを指定しないと、ossutilは一時オブジェクトを生成し、オブジェクトをアップロードして接続を検出します。
-- bucketname
任意
接続を確認するバケットの名前。
-- object
任意
アップロードするオブジェクトの名前。 コマンドでこのパラメーターを指定すると、アップロードされたオブジェクトは指定されたバケットに保存されます。 コマンドでこのパラメーターを指定しない場合、接続検出が完了した後、アップロードされたオブジェクトは削除されます。
-- addr
任意
接続を確認するネットワークアドレスを指定します。 ossutilはpingコマンドを実行して、ローカルコンピューターと指定されたアドレス間のネットワーク接続を確認します。
デフォルト値:
www.aliyun.com
-- upmode
任意
オブジェクトのアップロードに使用されるメソッド。
有効な値:
normal: これはデフォルト値です。 オブジェクトは、シンプルアップロードを使用してアップロードされます。
append: オブジェクトは、追加アップロードを使用してアップロードされます。
multipart: オブジェクトはマルチパートアップロードを使用してアップロードされます。
例
ランダムなオブジェクトをアップロードし、ネットワークアドレスを指定してネットワークをチェックします
この例では、オブジェクトがアップロードされるバケットの名前はexamplebucketで、確認するネットワークアドレスは
aliyun.com
です。 サンプルコマンド:./ossutil64 probe -- upload -- bucketname examplebucket -- 追加r aliyun.com
サンプル出力:
解析パラメータを開始し、ファイルを準備します...[✓] ネットワーク検出を開始...[✓] ファイルのアップロードを開始 (通常)...[✓] ************************* アップロード結果 ************************* アップロードファイル: 成功 アップロードファイルサイズ: 122880 (バイト) アップロードの時間がかかる: 245(ms) (probeコマンドで消費される時間のみ) ************************* レポートログ情報 ************************* レポートログファイル:/root/logOssProbe20201201173031.log
デフォルトのシンプルアップロードモードで指定したオブジェクトをアップロードしてネットワーク接続を確認し、検出完了後にアップロードしたオブジェクトを削除します
この例では、ローカルルートディレクトリにあるexample.txtという名前のファイルが、examplebucketという名前のバケットにアップロードされます。 サンプルコマンド:
./ossutil64 probe -- upload example.txt -- bucketname examplebucket
サンプル出力:
解析パラメータを開始し、ファイルを準備します...[✓] ネットワーク検出を開始...[✓] ファイルのアップロードを開始 (通常)...[✓] ************************* アップロード結果 ************************* アップロードファイル: 成功 アップロードファイルサイズ: 7 (バイト) アップロードの時間がかかる: 224(ms) (probeコマンドで消費される時間のみ) アップロードオブジェクトはexample.txtです ************************* レポートログ情報 ************************* レポートログファイル:/root/logOssProbe20201201173841.log
追加アップロードモードで指定されたオブジェクトをアップロードしてネットワーク接続を確認し、検出完了後にアップロードされたオブジェクトをバケットに格納します
この例では、ローカルルートディレクトリにあるexample.txtという名前のファイルが、examplebucketという名前のバケットにアップロードされます。 サンプルコマンド:
./ossutil64 probe -- upload example.txt -- bucketname examplebucket -- object example.txt -- upmode append
サンプル出力:
解析パラメータを開始し、ファイルを準備します...[✓] ネットワーク検出を開始...[✓] ファイルのアップロードを開始 (追加)...[✓] ************************* アップロード結果 ************************* アップロードファイル: 成功 アップロードファイルサイズ: 7 (バイト) アップロードの時間がかかる: 171(ms) (probeコマンドで消費される時間のみ) アップロードオブジェクトはexample.txtです ************************* レポートログ情報 ************************* レポートログファイル:/root/logOssProbe20201201174126.log
URLを使用してオブジェクトをダウンロードしてネットワーク接続を確認し、レポートを生成する
ossutilは、バケットからURLを使用してオブジェクトをダウンロードすることにより、ローカルクライアントとバケット間のネットワーク接続をチェックします。
コマンド構文
./ossutil64 probe {-- download} {-- url http_url} [-- addr=domain_name] [file_name]
次の表に、上記のコマンドのパラメーターを示します。
パラメーター
必須
説明
-- ダウンロード
可
オブジェクトをダウンロードして接続チェックを実行することを指定します。
-- url
可
ダウンロードするオブジェクトのURL。 ossutilはこのURLを使用して、オブジェクトをローカルディレクトリにダウンロードします。
ダウンロードするオブジェクトのACLがpublic-readの場合、このパラメーターをオブジェクトのURLに設定します。 例:
https://examplebucket.oss-cn-beijing.aliyuncs.com/example.jpg
。ダウンロードするオブジェクトのACLが非公開の場合、このパラメーターをオブジェクトの署名付きURLに設定します。 URLは二重引用符 ("") で囲む必要があります。 例:
「https://examplebucket.oss-cn-beijing.aliyuncs.com/example.jpg?Expires=1552015472&OSSAccessKeyId=TMP. ****** 5r9f1FV12y8_Qis6LUVmvoSCUSs7aboCCHtydQ0axN32Sn-UvyY3AAAwLAIUarYNLcO87AKMEcE5O3A ****** oCFAQuRdZYyVFyqOW8QkGAN-bamUiQと署名=bIa4llbMbldrl7rwckr % 2FXXvTtxw % 3D」
-- addr
任意
接続を確認するネットワークアドレスを指定します。 ossutilはpingコマンドを実行して、ローカルコンピューターと指定されたアドレス間のネットワーク接続を確認します。
デフォルト値:
www.aliyun.com
file_name
任意
オブジェクトがダウンロードされるローカルパス。
オブジェクト名のみを指定し、ディレクトリを指定しない場合、オブジェクトはossutilのインストールディレクトリに指定された名前で格納されます。
ディレクトリのみを指定し、オブジェクト名を指定しない場合は、指定したディレクトリに元の名前でオブジェクトが格納されます。
このパラメーターを指定しないと、オブジェクトはossutilのインストールディレクトリに元の名前で保存されます。
例
URLを使用して指定したオブジェクトをダウンロードしてネットワーク接続を確認し、オブジェクトの名前を変更する
この例では、ACLがパブリック読み取りである
example.txt
オブジェクトがhttps://examplebucket.oss-cn-beijing.aliyuncs.com/example.txt
からローカルディレクトリにダウンロードされ、名前が/localfile/test.txt
に変更されます。 サンプルコマンド:./ossutil64 probe -- download -- url https://examplebucket.oss-cn-beijing.aliyuncs.com/example.txt /localfile/test.txt
サンプル出力:
解析パラメータを開始し、オブジェクトを準備する...[✓] ネットワーク検出を開始...[✓] ファイルのダウンロードを開始...[✓] ************************* ダウンロード結果 ************************* ダウンロードファイル: 成功 ダウンロードファイルのサイズ: 57374182 (バイト) 時間のかかるダウンロード: 1246(ms) (probeコマンドで消費される時間のみ) ダウンロードファイルは /localfile/test.txtです ************************* レポートログ情報 ************************* レポートログファイル:/root/logOssProbe20201202171639.log
URLを使用して指定したオブジェクトをダウンロードし、pingテストのネットワークアドレスを指定して、ネットワーク接続を確認します。
この例では、ACLがパブリック読み取りである
example.txt
オブジェクトがhttps://examplebucket.oss-cn-beijing.aliyuncs.com/example.txt
からローカルディレクトリにダウンロードされ、pingテストのネットワークアドレスがaliyun.com
されます。 サンプルコマンド:./ossutil64 probe -- download -- url https://examplebucket.oss-cn-beijing.aliyuncs.com/example.txt -- r aliyun.comを追加
サンプル出力:
解析パラメータを開始し、オブジェクトを準備する...[✓] ネットワーク検出を開始...[✓] ファイルのダウンロードを開始...[✓] ************************* ダウンロード結果 ************************* ダウンロードファイル: 成功 ダウンロードファイルのサイズ: 57374182 (バイト) 時間のかかるダウンロード: 1344(ms) (probeコマンドで消費される時間のみ) ダウンロードファイルは /root/example.txtです ************************* レポートログ情報 ************************* レポートログファイル:/root/logOssProbe20201202172232.log
指定したオブジェクトをダウンロードしてネットワーク接続を確認し、レポートを生成する
ossutilは、バケットからオブジェクトをダウンロードすることにより、ローカルクライアントとバケット間のネットワーク接続をチェックします。
コマンド構文
./ossutil64 probe {-- download} {-- bucketname bucket_name} [-- object object_name] [-- addr domain_name] [file_name]
次の表に、上記のコマンドのパラメーターを示します。
パラメーター
必須
説明
-- ダウンロード
可
オブジェクトをダウンロードして接続チェックを実行することを指定します。
-- bucketname
可
接続を確認するバケットの名前。
-- object
任意
ダウンロードするオブジェクトの名前。 コマンドでこのパラメーターを指定すると、指定したオブジェクトがローカルディレクトリにダウンロードされます。 コマンドでこのパラメーターを指定しない場合、ossutilは一時オブジェクトを生成し、指定されたバケットにオブジェクトをアップロードしてから、オブジェクトをダウンロードします。 接続チェックが完了すると、ossutilはバケットから一時オブジェクトを削除します。
-- addr
任意
接続を確認するネットワークアドレスを指定します。 ossutilはpingコマンドを実行して、ローカルコンピューターと指定されたアドレス間のネットワーク接続を確認します。
デフォルト値:
www.aliyun.com
file_name
任意
オブジェクトがダウンロードされるローカルパス。
オブジェクト名のみを指定し、ディレクトリを指定しない場合、オブジェクトはossutilのインストールディレクトリに指定された名前で格納されます。
ディレクトリのみを指定し、オブジェクト名を指定しない場合は、指定したディレクトリに元の名前でオブジェクトが格納されます。
このパラメーターを指定しないと、オブジェクトはossutilのインストールディレクトリに元の名前で保存されます。
例
指定したオブジェクトをダウンロードしてネットワーク接続を確認し、オブジェクトの名前を変更する
この例では、
/ossfolder/example.txt
オブジェクトがexamplebucketバケットからダウンロードされ、名前が/localfolder/text.txt
に変更されます。 サンプルコマンド:./ossutil64 probe -- download -- bucketname examplebucket -- object /ossfolder/example.txt /localfolder/text.txt
サンプル出力:
解析パラメータを開始し、オブジェクトを準備する...[✓] ネットワーク検出を開始...[✓] ファイルのダウンロードを開始...[✓] ************************* ダウンロード結果 ************************* ダウンロードファイル: 成功 ダウンロードファイルのサイズ: 57374182 (バイト) 時間のかかるダウンロード: 1108(ms) (probeコマンドで消費される時間のみ) ダウンロードファイルは /localfolder/text.txtです ************************* レポートログ情報 ************************* レポートログファイル:/root/logOssProbe20201202173032.log
一時オブジェクトをダウンロードし、pingテスト用のネットワークのアドレスを指定して、ネットワーク接続ステータスを確認します。
この例では、一時オブジェクトはexamplebucketバケットからダウンロードされます。 確認するネットワークアドレスが
aliyun.com
です。 サンプルコマンド:./ossutil64 probe -- download -- bucketname examplebucket -- r aliyun.comを追加
サンプル出力:
解析パラメータを開始し、オブジェクトを準備する...[✓] ネットワーク検出を開始...[✓] ファイルのダウンロードを開始...[✓] ************************* ダウンロード結果 ************************* ダウンロードファイル: 成功 ダウンロードファイルのサイズ: 122880 (バイト) 時間のかかるダウンロード: 516(ms) (probeコマンドで消費される時間のみ) ダウンロードファイルは /root/oss-test-probe-1606902911701892000-3ifwj9t0lnです ************************* レポートログ情報 ************************* レポートログファイル:/root/logOssProbe20201202173512.log
特定のアイテムを確認する
probeコマンドを実行して、ローカルのシンボリックリンクのステータス、アップロードおよびダウンロードの帯域幅など、特定の項目を確認できます。 ossutilは、チェック結果に基づいて、異常なシンボリックリンクの名前と、アップロードおよびダウンロードでの推奨される同時タスク数も返します。
コマンド構文
./ossutil64 probe {-- probe-item item_value} {-- bucketname bucket-name} [-- object object_name][-- parallel <value>][-- part-size <value>][-- runtime <value>]
次の表に、上記のコマンドのパラメーターを示します。
パラメーター
必須
説明
-- probe-item
可
チェックするアイテム。
有効な値:
cycle-symlink: ossutilは、ローカルの異常なシンボリックリンクが存在するかどうかをチェックします。
upload-speed: ossutilはアップロード帯域幅をチェックします。
download-speed: ossutilはダウンロード帯域幅をチェックします。
download-time: ossutilは、ダウンロードに必要な時間をチェックします。
-- bucketname
-- probe-itemの値が
cycle-symlink
でない場合のみバケットの名前です。
-- object
-- probe-itemの値が
download-speed
の場合のみダウンロードするオブジェクトのパス。 オブジェクトが存在し、サイズが5 MBを超える必要があります。 例:
ossfolder/example.txt
-- 平行
任意
1つのオブジェクトに対する操作の同時タスクの数。 デフォルト値は 1 です。
説明このパラメーターは、-- probe-itemの値が
download-time
の場合にのみ有効です。-- 部分サイズ
任意
部品サイズ。 単位:バイト デフォルトでは、ossutilはオブジェクトサイズに基づいて部品サイズを決定します。
有効な値: 1 ~ 9223372036854775807
説明このパラメーターは、-- probe-itemの値が
download-time
の場合にのみ有効です。-- runtime
任意
最大実行時間。 最大実行時間を超えた場合, コマンドの実行が中断されます。
説明このパラメーターは、-- probe-itemの値が
upload-speed
またはdownload-speed
の場合にのみ有効になります。例
ローカルルートディレクトリのlocalfolderディレクトリに異常なシンボリックリンクが存在するかどうかを確認する
サンプルコマンド:
./ossutil64 probe -- probe-item cycle-symlink /root/localfolder
サンプル出力:
エラー: stat /root/localfolder/example.jpg: そのようなファイルまたはディレクトリがありません
出力は、example.jpgシンボリックリンクが異常であることを示しています。
アップロード帯域幅の確認
この例では、ossutilは一時オブジェクトをexamplebucketという名前のバケットにアップロードし、現在のデバイスのハードウェア仕様とアップロード帯域幅に基づいて推奨される同時アップロードタスク数を返します。
サンプルコマンド:
./ossutil64 probe -- probe-item upload-speed -- bucketname examplebucket
サンプル出力:
cpuコア数: 2 パラレル: 2、平均速度: 679.72(KB/s) 、現在の速度: 1344.00(KB/s) 、最大速度: 1440.00(KB/s) パラレル: 3、平均速度: 643.31(KB/s) 、現在の速度: 704.00(KB/s) 、最大速度: 1632.00(KB/s) パラレル: 4、平均速度: 646.62(KB/s) 、現在の速度: 512.00(KB/s) 、最大速度: 1600.00(KB/s) パラレルは2、最大平均速度は679.72(KB/s)
出力は、デバイスのCPUに2つのコアがあり、最大平均アップロード帯域幅は679.72 KB/sであり、同時アップロードタスクの推奨数は2であることを示しています。
ダウンロード帯域幅の確認
この例では、ossutilはexamplebucketバケットから
example.txt
オブジェクトをダウンロードし、ハードウェアのパフォーマンスとダウンロード帯域幅に基づいて同時ダウンロードタスクの数を推奨します。サンプルコマンド:
./ossutil64 probe -- probe-item download-speed -- bucketname examplebucket -- object example.txt
サンプル出力:
cpuコア数: 2 パラレル: 2、平均速度: 12524.93(KB/s) 、現在の速度: 12288.63(KB/s) 、最大速度: 14302.25(KB/s) パラレル: 3、平均速度: 12564.45(KB/s) 、現在の速度: 12144.39(KB/s) 、最大速度: 14484.24(KB/s) パラレル: 4、平均速度: 12545.21(KB/s) 、現在の速度: 12766.58(KB/s) 、最大速度: 13534.42(KB/s) パラレルは3、最大平均速度は12564.45(KB/s)
出力は、デバイスのCPUに2つのコアがあり、最大平均ダウンロード帯域幅が12,564.45 KB/sであり、ハードウェアのパフォーマンスとダウンロード帯域幅に基づく同時ダウンロードタスクを示しています。
ダウンロード帯域幅を確認し、最大実行時間を指定する
この例では、ossutilはexamplebucketバケットから
example.zip
オブジェクトをダウンロードし、ハードウェアパフォーマンスとダウンロード帯域幅に基づいて推奨される同時ダウンロードタスク数を返し、最大実行時間を指定します。./ossutil64 probe -- probe-item download-speed -- bucketname examplebucket -- object example.zip -- runtime 2
サンプル出力:
cpuコア数: 8 パラレル: 8、平均速度: 10610.66(KB/s) 、現在の速度: 11245.14(KB/s) 、最大速度: 11470.41(KB/s) パラレル: 9、平均速度: 9915.97(KB/s) 、現在の速度: 10763.22(KB/s) 、最大速度: 11401.97(KB/s) パラレル: 10、平均速度: 9969.66(KB/s) 、現在の速度: 11213.43(KB/s) 、最大速度: 11384.52(KB/s) パラレル: 11、平均速度: 10298.34(KB/s) 、現在の速度: 10522.27(KB/s) 、最大速度: 11282.21(KB/s) パラレル: 12、平均速度: 10454.31(KB/s) 、現在の速度: 9725.25(KB/s) 、最大速度: 11426.21(KB/s) パラレル: 13、平均速度: 9531.86(KB/s) 、現在の速度: 8634.53(KB/s) 、最大速度: 11220.90(KB/s)) パラレル: 14、平均速度: 9329.45(KB/s) 、現在の速度: 8542.94(KB/s) 、最大速度: 10505.16(KB/s) パラレル: 15、平均速度: 10193.00(KB/s) 、現在の速度: 10770.35(KB/s) 、最大速度: 10971.39(KB/s) パラレル: 16、平均速度: 10637.59(KB/s) 、現在の速度: 10483.77(KB/s) 、最大速度: 11179.55(KB/s) パラレルは16、最大平均速度は10637.59(KB/s) ダウンロードを実行する-パラレル2で速度16秒 パラレル: 16、平均速度: 9197.00(KB/s) 、現在の速度: 9849.30(KB/s) 、最大速度: 9849.30(KB/s) 280.345640経過
ダウンロードによって消費された時間を確認する
この例では、ossutilはexamplebucketバケットから
example.txt
オブジェクトをダウンロードし、ダウンロードタスクによって消費された時間を返します。 サンプルコマンド:./ossutil64 probe -- probe-item download-time -- bucketname examplebucket -- object example.txt
サンプル出力:
ダウンロード平均速度: 6178.75(KB/s) 、現在速度: 14446.02(KB/s) 、最大速度: 14446.02(KB/s) download-speed part-size:-1、parallel: 合計1バイト: 31707929、コスト: 4.918秒、平均速度: 7741.00(kB/s) 5.206202経過
ダウンロードにかかる時間を確認し、部品サイズを設定する
この例では、ossutilは、部品サイズが設定されたexamplebucketバケットから
example.zip
オブジェクトをダウンロードし、ダウンロードタスクによって消費された時間を返します。./ossutil64 probe -- probe-item download-time -- bucketname examplebucket -- object example.zip -- パートサイズの10000000
サンプル出力:
ダウンロード平均速度: 9229.00(KB/s) 、現在速度: 18458.57(KB/s) 、最大速度: 18458.57(KB/s) ダウンロード速度部分サイズ: 10000000、パラレル: 合計1バイト: 31707929、コスト: 3.230秒、平均速度: 10321.33(kB/s) 3.569254経過
ダウンロードによって消費された時間を確認し、同時実行レベルを設定する
この例では、ossutilは、部品サイズが設定されたexamplebucketバケットから
example.zip
オブジェクトをダウンロードし、ダウンロードタスクによって消費された時間を返します。./ossutil64 probe -- probe-item download-time -- bucketname examplebucket -- object example.zip -- parallel 3
サンプル出力:
ダウンロード平均速度: 9155.00(KB/s) 、現在速度: 18310.68(KB/s) 、最大速度: 18310.68(KB/s) ダウンロード-速度部分サイズ:-1、パラレル: 合計3バイト: 31707929、コスト: 3.121秒、平均速度: 10321.33(kB/s) 経過した3.424191