Bu konu, yerel istemci ile Object Storage Service (OSS) arasındaki ağ bağlantısındaki anormallikleri algılamak, yükleme ve indirme bant genişliklerini kontrol etmek ve yerel sembolik bağlantıların durumunu almak için probe komutunun nasıl kullanılacağını açıklar.
Kullanım notları
Yükleme bant genişliğini kontrol etmek için
oss:GetObject,oss:PutObjectveoss:DeleteObjectizinlerine sahip olmanız gerekir. İndirme bant genişliğini kontrol etmek içinoss:GetObjectiznine sahip olmanız yeterlidir. Daha fazla bilgi için bkz. Özel ilke atama.ossutil 1.6.16 ve sonraki sürümlerde, komut satırında ikili dosya adı olarak doğrudan ossutil kullanabilirsiniz. İşletim sistemine göre ikili dosya adını güncellemeniz gerekmez. 1.6.16'dan önceki ossutil sürümlerinde işletim sistemine göre ikili dosya adını güncellemeniz gerekir. Daha fazla bilgi için bkz. ossutil komut referansı.
Kullanım notları
probe komutunu çalıştırarak yerel istemci ile OSS arasındaki ağ bağlantısındaki anormallikleri tespit edebilir ve yükleme/indirme bant genişliklerini kontrol edebilirsiniz. Ayrıca, büyük miktarda sembolik bağlantıyı yüklemeden önce bu komutu kullanarak durumlarını kontrol edebilirsiniz.
-
Ağ anormalliklerini tespit etme
ossutil, nesneleri yükleyerek veya indirerek yerel istemci ile OSS arasındaki ağ bağlantısının durumunu kontrol eder. Ağ anormalliklerini tespit ederken nesneleri belirtilen konuma yüklemek veya indirmek istiyorsanız gerçek nesne adlarını belirtmenizi öneririz. Yalnızca ağ anormalliklerini tespit etmeniz gerekiyorsa nesne adlarını belirtmeden komutu çalıştırın. ossutil, bağlantı testi için geçici nesneler oluşturur ve test tamamlandıktan sonra bu nesneleri siler.
-
Yükleme ve indirme bant genişliklerini kontrol etme
Bu komutu çalıştırarak yükleme ve indirme bant genişliklerini kontrol ettiğinizde, OSS yerel cihazlarınızın CPU'suna ve ağ bant genişliğinize bağlı olarak eşzamanlı görev sayısı için bir öneri sunar. Ağ bant genişliğinizden en üst düzeyde yararlanmak için önerilen eşzamanlı görev sayısını kullanabilirsiniz.
-
Yerel sembolik bağlantıların durumunu kontrol etme
Büyük miktarda sembolik bağlantı yüklerken bağlantılardan biri anormal olduğunda yükleme işlemi kesintiye uğrar. Bu nedenle, sembolik bağlantıları yüklemeden önce durumlarını kontrol etmenizi öneririz. Sembolik bağlantılardan biri anormal ise bağlantıları yüklemeden önce sorunu giderin.
probe komutunu çalıştırdıktan sonra her bir yükleme veya indirme görevinin ilerleme durumunu ve sonucunu görüntüleyebilirsiniz.
-
Nesneleri yükleyerek veya indirerek ağ anormalliklerini tespit etme
Onay işareti (√), kontrol sonucunun olumlu olduğunu gösterir. Çarpı işareti (×), kontrol sonucunun olumsuz olduğunu gösterir.
Tespit başarılı olursa ossutil; yüklenen veya indirilen nesnenin boyutu, yükleme ya da indirme işleminin ne kadar sürdüğü ve nesnenin yüklendiği veya indirildiği konum dahil olmak üzere yükleme veya indirme göreviyle ilgili bilgileri döndürür.
-
Tespit başarısız olursa ossutil, hataları gidermek için kullanılabilecek hata nedenlerini veya hata kodlarını döndürür.
Hata kodları hakkında daha fazla bilgi için bkz. Hata yanıtı.
Tespit işlemi tamamlandığında ossutil, kurulum dizininde
logOssProbe+DetectionCompletionTime.logbiçiminde adlandırılmış bir günlük dosyası oluşturur. Günlük dosyası probe komutuyla ilgili ayrıntılı bilgileri içerir.
-
Belirli bir öğeyi kontrol etme
Probe komutunu çalıştırarak yükleme ve indirme bant genişliklerini veya yerel sembolik bağlantıların durumunu kontrol ettiğinizde ossutil kontrol sonuçlarını ve önerileri sağlar.
Bir nesne yükleyerek ağ bağlantısı durumunu kontrol edin ve rapor oluşturun
ossutil, bir pakete nesne yükleyerek yerel istemci ile paket arasındaki ağ bağlantısı durumunu kontrol eder.
-
Komut sözdizimi
ossutil probe {--upload [file_name]} {--bucketname bucket_name} [--object object_name] [--addr domain_name] [--upmode]Aşağıdaki tabloda önceki komuttaki parametreler açıklanmaktadır.
Parametre
Zorunlu
Açıklama
--upload
Evet
Bağlantı testinin bir nesne yüklenerek gerçekleştirileceğini belirtir.
file_name
Hayır
Pakete yüklemek istediğiniz yerel dosyanın tam yolu. Bu parametreyi belirtmezseniz ossutil geçici bir nesne oluşturur ve nesneyi yükleyerek bağlantı testi yapar.
--bucketname
Hayır
Bağlantısını kontrol etmek istediğiniz paketin adı.
--object
Hayır
Yüklenen dosya için belirttiğiniz nesne adı. Bu parametreyi komutta belirtirseniz ossutil yüklenen dosyayı belirtilen adla belirtilen pakette depolar. Komutta bu parametreyi belirtmezseniz ossutil bağlantı testi tamamlandıktan sonra yüklenen dosyayı siler.
--addr
Hayır
Ağ adresini belirtir. ossutil, yerel bilgisayarınız ile belirtilen adres arasındaki ağ bağlantısını kontrol etmek için ping işlemi kullanır.
Varsayılan değer:
www.aliyun.com.--upmode
Hayır
Nesnenin yüklenme yöntemi.
Geçerli değerler:
-
normal (varsayılan): Nesne basit yükleme kullanılarak yüklenir.
-
append: Nesne eklemeli yükleme kullanılarak yüklenir.
-
multipart: Nesne çok parçalı yükleme kullanılarak yüklenir.
-
-
Örnekler
-
Rastgele bir nesne yükleyerek ve ağ adresini belirterek ağ bağlantısını kontrol edin
Bu örnekte nesnenin yüklendiği paket examplebucket olarak adlandırılır ve kontrol edilecek ağ adresi
aliyun.comşeklindedir. Örnek komut:ossutil probe --upload --bucketname examplebucket --addr aliyun.comÖrnek çıktı:
begin parse parameters and prepare file...[✓] begin network detection...[✓] begin upload file(normal)...[✓] ************************* upload result ************************* upload file:success upload file size:122880(byte) upload time consuming:245(ms) (only the time consumed by probe command) ************************* report log info************************* report log file:/root/logOssProbe20201201173031.log -
Varsayılan basit yükleme modunda belirli bir nesne yükleyerek ağ bağlantısını kontrol edin ve tespit tamamlandığında yüklenen nesneyi silin
Bu örnekte, yerel kök dizindeki example.txt adlı bir dosya examplebucket adlı pakete yüklenir. Örnek komut:
ossutil probe --upload example.txt --bucketname examplebucketÖrnek çıktı:
begin parse parameters and prepare file...[✓] begin network detection...[✓] begin upload file(normal)...[✓] ************************* upload result ************************* upload file:success upload file size:7(byte) upload time consuming:224(ms) (only the time consumed by probe command) upload object is example.txt ************************* report log info************************* report log file:/root/logOssProbe20201201173841.log -
Eklemeli yükleme modunda belirtilen bir nesne yükleyerek ağ bağlantısını kontrol edin ve tespit tamamlandığında yüklenen nesneyi pakette saklayın
Bu örnekte, yerel kök dizindeki example.txt adlı bir dosya examplebucket adlı pakete yüklenir. Örnek komut:
ossutil probe --upload example.txt --bucketname examplebucket --object example.txt --upmode appendÖrnek çıktı:
begin parse parameters and prepare file...[✓] begin network detection...[✓] begin upload file(append)...[✓] ************************* upload result ************************* upload file:success upload file size:7(byte) upload time consuming:171(ms) (only the time consumed by probe command) upload object is example.txt ************************* report log info************************* report log file:/root/logOssProbe20201201174126.log
-
URL kullanarak bir nesne indirerek ağ bağlantısını kontrol edin ve rapor oluşturun
ossutil, bir paketten URL kullanarak bir nesne indirerek yerel istemci ile paket arasındaki ağ bağlantısını kontrol eder.
-
Komut sözdizimi
ossutil probe {--download} {--url http_url} [--addr=domain_name] [file_name]Aşağıdaki tabloda önceki komuttaki parametreler açıklanmaktadır.
Parametre
Zorunlu
Açıklama
--download
Evet
Bağlantı kontrolünün bir nesne indirilerek gerçekleştirileceğini belirtir.
--url
Evet
İndirmek istediğiniz nesnenin URL'si. ossutil bu URL'yi kullanarak nesneyi yerel bir dizine indirir.
-
İndirmek istediğiniz nesnenin Erişim Kontrol Listesi (ACL) public-read ise bu parametreyi nesnenin URL'si olarak ayarlayın. Örnek:
https://examplebucket.oss-cn-beijing.aliyuncs.com/example.jpg. -
İndirmek istediğiniz nesnenin Erişim Kontrol Listesi (ACL) private ise bu parametreyi nesnenin imzalı URL'si olarak ayarlayın. URL çift tırnak işaretleri ("") içine alınmalıdır. Örnek:
"https://examplebucket.oss-cn-beijing.aliyuncs.com/example.jpg?Expires=1552015472&OSSAccessKeyId=TMP.5r9f1FV12y8_Qis6LUVmvoSCUSs7aboCCHtydQ0axN32Sn-UvyY3AAAwLAIUarYNLcO87AKMEcE5O3AoCFAQuRdZYyVFyqOW8QkGAN-bamUiQ&Signature=bIa4llbMbldrl7rwckr%2FXXvTtxw%3D".
--addr
Hayır
Ağ adresini belirtir. ossutil, yerel bilgisayarınız ile belirtilen adres arasındaki ağ bağlantısını kontrol etmek için ping işlemi kullanır.
Varsayılan değer:
www.aliyun.com.file_name
Hayır
Nesnenin indirileceği yerel yol.
-
Yalnızca nesne adını belirtip bir dizin belirtmezseniz nesne, belirtilen adla ossutil kurulum dizininde depolanır.
-
Yalnızca bir dizin belirtip nesne adını belirtmezseniz nesne, orijinal adıyla belirtilen dizinde depolanır.
-
Bu parametreyi belirtmezseniz nesne, orijinal adıyla ossutil kurulum dizininde depolanır.
-
-
Örnekler
-
Nesne URL'sini kullanarak belirli bir nesne indirerek ağ bağlantısını kontrol edin ve nesneyi yeniden adlandırın
Bu örnekte, Erişim Kontrol Listesi (ACL) public-read olan
example.txtnesnesihttps://examplebucket.oss-cn-beijing.aliyuncs.com/example.txtkonumundan yerel bir dizine indirilir ve/localfile/test.txtolarak yeniden adlandırılır. Örnek komut:ossutil probe --download --url https://examplebucket.oss-cn-beijing.aliyuncs.com/example.txt /localfile/test.txtÖrnek çıktı:
begin parse parameters and prepare object...[✓] begin network detection...[✓] begin download file...[✓] ************************* download result ************************* download file:success download file size:57374182(byte) download time consuming:1246(ms) (only the time consumed by probe command) download file is /localfile/test.txt ************************* report log info************************* report log file:/root/logOssProbe20201202171639.log -
URL kullanarak bir nesne indirerek ve ping testi için ağ adresini belirterek ağ bağlantısını kontrol edin
Bu örnekte, Erişim Kontrol Listesi (ACL) public-read olan
example.txtnesnesihttps://examplebucket.oss-cn-beijing.aliyuncs.com/example.txtkonumundan yerel bir dizine indirilir ve ping testi için ağ adresialiyun.comolarak belirlenir. Örnek komut:ossutil probe --download --url https://examplebucket.oss-cn-beijing.aliyuncs.com/example.txt --addr aliyun.comÖrnek çıktı:
begin parse parameters and prepare object...[✓] begin network detection...[✓] begin download file...[✓] ************************* download result ************************* download file:success download file size:57374182(byte) download time consuming:1344(ms) (only the time consumed by probe command) download file is /root/example.txt ************************* report log info************************* report log file:/root/logOssProbe20201202172232.log
-
Belirtilen bir nesneyi indirerek ağ bağlantısını kontrol edin ve rapor oluşturun
ossutil, bir paketten bir nesne indirerek yerel istemci ile paket arasındaki ağ bağlantısını kontrol eder.
-
Komut sözdizimi
ossutil probe {--download} {--bucketname bucket_name} [--object object_name] [--addr domain_name] [file_name]Aşağıdaki tabloda önceki komuttaki parametreler açıklanmaktadır.
Parametre
Zorunlu
Açıklama
--download
Evet
Bağlantı kontrolünün bir nesne indirilerek gerçekleştirileceğini belirtir.
--bucketname
Evet
Bağlantısını kontrol etmek istediğiniz paketin adı.
--object
Hayır
İndirmek istediğiniz nesnenin adı. Bu parametreyi komutta belirtirseniz ossutil belirtilen nesneyi yerel bir dizine indirir. Komutta bu parametreyi belirtmezseniz ossutil geçici bir nesne oluşturur, nesneyi belirtilen pakete yükler ve ardından nesneyi indirir. Bağlantı kontrolü tamamlandığında ossutil geçici nesneyi paketten siler.
--addr
Hayır
Ağ adresini belirtir. ossutil, yerel bilgisayarınız ile belirtilen adres arasındaki ağ bağlantısını kontrol etmek için ping işlemi kullanır.
Varsayılan değer:
www.aliyun.com.file_name
Hayır
Nesnenin indirileceği yerel yol.
-
Yalnızca nesne adını belirtip bir dizin belirtmezseniz nesne, belirtilen adla ossutil kurulum dizininde depolanır.
-
Yalnızca bir dizin belirtip nesne adını belirtmezseniz nesne, orijinal adıyla belirtilen dizinde depolanır.
-
Bu parametreyi belirtmezseniz nesne, orijinal adıyla ossutil kurulum dizininde depolanır.
-
-
Örnekler
-
Bir nesne indirerek ağ bağlantısını kontrol edin ve nesneyi yeniden adlandırın
Bu örnekte,
ossfolder/example.txtnesnesi examplebucket paketinden indirilir ve/localfolder/text.txtolarak yeniden adlandırılır. Örnek komut:ossutil probe --download --bucketname examplebucket --object ossfolder/example.txt /localfolder/text.txtÖrnek çıktı:
begin parse parameters and prepare object...[✓] begin network detection...[✓] begin download file...[✓] ************************* download result ************************* download file:success download file size:57374182(byte) download time consuming:1108(ms) (only the time consumed by probe command) download file is /localfolder/text.txt ************************* report log info************************* report log file:/root/logOssProbe20201202173032.log -
Geçici bir nesne indirerek ve ping testi için ağ adresini belirterek ağ bağlantısı durumunu kontrol edin
Bu örnekte, examplebucket paketinden geçici bir nesne indirilir. Kontrol edilecek ağ adresi
aliyun.comşeklindedir. Örnek komut:ossutil probe --download --bucketname examplebucket --addr aliyun.comÖrnek çıktı:
begin parse parameters and prepare object...[✓] begin network detection...[✓] begin download file...[✓] ************************* download result ************************* download file:success download file size:122880(byte) download time consuming:516(ms) (only the time consumed by probe command) download file is /root/oss-test-probe-1606902911701892000-3ifwj9t0ln ************************* report log info************************* report log file:/root/logOssProbe20201202173512.log
-
Belirli bir öğeyi kontrol edin
Probe komutunu çalıştırarak yerel sembolik bağlantıların durumu ile yükleme ve indirme bant genişlikleri dahil olmak üzere belirli bir öğeyi kontrol edebilirsiniz. ossutil ayrıca kontrol sonuçlarına göre anormal sembolik bağlantıların adlarını ve yükleme/indirme işlemleri için önerilen eşzamanlı görev sayısını döndürür.
-
Komut sözdizimi
ossutil probe {--probe-item item_value} {--bucketname bucket-name} [--object object_name][--parallel <value>][--part-size <value>][--runtime <value>]Aşağıdaki tabloda önceki komuttaki parametreler açıklanmaktadır.
Parametre
Zorunlu
Açıklama
--probe-item
Evet
Kontrol etmek istediğiniz öğe.
Geçerli değerler:
-
cycle-symlink: ossutil, yerel yolda anormal sembolik bağlantı olup olmadığını kontrol eder.
-
upload-speed: ossutil yükleme bant genişliğini kontrol eder.
-
download-speed: ossutil indirme bant genişliğini kontrol eder.
-
download-time: ossutil bir nesnenin indirilmesi için gereken süreyi kontrol eder.
--bucketname
--probe-item değeri
cycle-symlinkolmadığında evetBağlantısını kontrol etmek istediğiniz paketin adı.
--object
--probe-item değeri
download-speedolduğunda evetNesnenin yolu. Nesne mevcut olmalıdır. Boyutu 5 MB'tan büyük bir nesne belirtmenizi öneririz. Örnek:
ossfolder/example.txt.--parallel
Hayır
Tek bir nesne üzerinde işlem yapmak için kullanılan eşzamanlı görev sayısı. Varsayılan değer: 1.
NotBu parametre yalnızca --probe-item değeri
download-timeolduğunda etkili olur.--part-size
Hayır
Parça boyutu. Birim: bayt. Varsayılan olarak ossutil, parça boyutunu nesne boyutuna göre belirler.
Geçerli değerler: 1 ila 9223372036854775807.
NotBu parametre yalnızca --probe-item değeri
download-timeolduğunda etkili olur.--runtime
Hayır
Maksimum yürütme süresi. Maksimum yürütme süresine ulaşıldığında komut yürütmesi kesintiye uğrar.
NotBu parametre yalnızca --probe-item değeri
upload-speedveyadownload-speedolduğunda etkili olur. -
-
Örnekler
-
Yerel kök dizindeki localfolder dizininde anormal sembolik bağlantı olup olmadığını kontrol edin
Örnek komut:
ossutil probe --probe-item cycle-symlink /root/localfolderÖrnek çıktı:
Error: stat /root/localfolder/example.jpg: no such file or directoryÇıktı, example.jpg sembolik bağlantısının anormal olduğunu gösterir.
-
Yükleme bant genişliğini kontrol edin
Bu örnekte ossutil, examplebucket adlı bir pakete geçici bir nesne yükler ve mevcut cihazın donanım özelliklerine ve yükleme bant genişliğine göre önerilen eşzamanlı yükleme görevi sayısını döndürür.
Örnek komut:
ossutil probe --probe-item upload-speed --bucketname examplebucketÖrnek çıktı:
cpu core count:2 parallel:2,average speed:679.72(KB/s),current speed:1344.00(KB/s),max speed:1440.00(KB/s)) parallel:3,average speed:643.31(KB/s),current speed:704.00(KB/s),max speed:1632.00(KB/s)) parallel:4,average speed:646.62(KB/s),current speed:512.00(KB/s),max speed:1600.00(KB/s)) suggest parallel is 2, max average speed is 679.72(KB/s)Çıktı, cihazın CPU'sunun iki çekirdekli olduğunu, maksimum ortalama yükleme bant genişliğinin 679,72 KB/sn olduğunu ve önerilen eşzamanlı yükleme görevi sayısının 2 olduğunu gösterir.
-
İndirme bant genişliğini kontrol edin
Bu örnekte ossutil, examplebucket paketinden
example.txtnesnesini indirir ve donanım performansı ile indirme bant genişliğine göre eşzamanlı indirme sayısını önerir.Örnek komut:
ossutil probe --probe-item download-speed --bucketname examplebucket --object example.txtÖrnek çıktı:
cpu core count:2 parallel:2,average speed:12524.93(KB/s),current speed:12288.63(KB/s),max speed:14302.25(KB/s) parallel:3,average speed:12564.45(KB/s),current speed:12144.39(KB/s),max speed:14484.24(KB/s) parallel:4,average speed:12545.21(KB/s),current speed:12766.58(KB/s),max speed:13534.42(KB/s) suggest parallel is 3, max average speed is 12564.45(KB/s)Çıktı, cihazın CPU'sunun iki çekirdekli olduğunu, maksimum ortalama indirme bant genişliğinin 12.564,45 KB/sn olduğunu ve önerilen eşzamanlı indirme görevi sayısının 3 olduğunu gösterir.
-
İndirme bant genişliğini kontrol edin ve maksimum yürütme süresini belirtin
Bu örnekte ossutil, examplebucket paketinden
example.zipnesnesini indirir, donanım performansı ve indirme bant genişliğine göre önerilen eşzamanlı indirme görevi sayısını döndürür ve maksimum yürütme süresi belirtilir.ossutil probe --probe-item download-speed --bucketname examplebucket --object example.zip --runtime 2Örnek çıktı:
cpu core count:8 parallel:8,average speed:10610.66(KB/s),current speed:11245.14(KB/s),max speed:11470.41(KB/s) parallel:9,average speed:9915.97(KB/s),current speed:10763.22(KB/s),max speed:11401.97(KB/s)) parallel:10,average speed:9969.66(KB/s),current speed:11213.43(KB/s),max speed:11384.52(KB/s)) parallel:11,average speed:10298.34(KB/s),current speed:10522.27(KB/s),max speed:11282.21(KB/s) parallel:12,average speed:10454.31(KB/s),current speed:9725.25(KB/s),max speed:11426.21(KB/s)) parallel:13,average speed:9531.86(KB/s),current speed:8634.53(KB/s),max speed:11220.90(KB/s))) parallel:14,average speed:9329.45(KB/s),current speed:8542.94(KB/s),max speed:10505.16(KB/s)) parallel:15,average speed:10193.00(KB/s),current speed:10770.35(KB/s),max speed:10971.39(KB/s) parallel:16,average speed:10637.59(KB/s),current speed:10483.77(KB/s),max speed:11179.55(KB/s) suggest parallel is 16, max average speed is 10637.59(KB/s) run download-speed 2 seconds with parallel 16 parallel:16,average speed:9197.00(KB/s),current speed:9849.30(KB/s),max speed:9849.30(KB/s) 280.345640(s) elapsed -
Bir indirme görevinin tamamlanması için gereken süreyi kontrol edin
Bu örnekte ossutil, examplebucket paketinden
example.txtnesnesini indirir ve bir indirme görevinin tamamlanması için gereken süreyi döndürür. Örnek komut:ossutil probe --probe-item download-time --bucketname examplebucket --object example.txtÖrnek çıktı:
downloading average speed:6178.75(KB/s),current speed:14446.02(KB/s),max speed:14446.02(KB/s) download-speed part-size:-1, parallel:1 total bytes:31707929, cost:4.918 s, avg speed:7741.00(kB/s) 5.206202(s) elapsed -
Bir indirme görevinin tamamlanması için gereken süreyi kontrol edin ve parça boyutunu belirtin
Bu örnekte ossutil, examplebucket paketinden belirtilen parça boyutuna göre
example.zipnesnesini indirir ve bir indirme görevinin tamamlanması için gereken süreyi döndürür.ossutil probe --probe-item download-time --bucketname examplebucket --object example.zip --part-size 10000000Örnek çıktı:
downloading average speed:9229.00(KB/s),current speed:18458.57(KB/s),max speed:18458.57(KB/s) download-speed part-size:10000000, parallel:1 total bytes:31707929, cost:3.230 s, avg speed:10321.33(kB/s) 3.569254(s) elapsed -
Bir indirme görevinin tamamlanması için gereken süreyi kontrol edin ve eşzamanlılık düzeyini yapılandırın
Bu örnekte ossutil, examplebucket paketinden belirtilen parça boyutuna göre
example.zipnesnesini indirir ve bir indirme görevinin tamamlanması için gereken süreyi döndürür.ossutil probe --probe-item download-time --bucketname examplebucket --object example.zip --parallel 3Örnek çıktı:
downloading average speed:9155.00(KB/s),current speed:18310.68(KB/s),max speed:18310.68(KB/s) download-speed part-size:-1, parallel:3 total bytes:31707929, cost:3.121 s, avg speed:10321.33(kB/s) 3.424191(s) elapsed
-