Object Storage Service:probe

Remarques

• Pour vérifier le débit d'envoi, vous devez disposer des autorisations oss:GetObject, oss:PutObject et oss:DeleteObject. Pour vérifier le débit de réception, vous devez disposer de l'autorisation oss:GetObject. Pour plus d'informations, consultez la section Grant a custom policy.

• À partir de la version 1.6.16 d'ossutil, utilisez directement ossutil comme nom binaire dans la ligne de commande. Il n'est pas nécessaire d'adapter le nom binaire en fonction du système d'exploitation. Pour les versions antérieures à 1.6.16, adaptez le nom binaire selon le système d'exploitation. Pour plus d'informations, consultez la section 命令行工具ossutil快速入门.

Remarques

Vérifier l'état de la connexion réseau en envoyant un objet et générer un rapport

ossutil vérifie l'état de la connexion réseau entre le client local et un bucket en envoyant un objet vers ce bucket.

• Syntaxe de la commande

  ossutil probe {--upload [file_name]} {--bucketname bucket_name} [--object object_name] [--addr domain_name] [--upmode]

  Le tableau suivant décrit les paramètres de la commande ci-dessus.

  Paramètre	Obligatoire	Description
  --upload	Oui	Indique que le test de connectivité est effectué par envoi d'un objet.
  file_name	Non	Chemin d'accès complet du fichier local à envoyer vers le bucket. Si ce paramètre n'est pas spécifié, ossutil génère un objet temporaire et teste la connectivité en l'envoyant.
  --bucketname	Non	Nom du bucket dont vous souhaitez vérifier la connexion.
  --object	Non	Nom de l'objet spécifié pour le fichier envoyé. Si ce paramètre est indiqué dans la commande, ossutil stocke le fichier envoyé dans le bucket spécifié sous le nom indiqué. Sinon, ossutil supprime le fichier envoyé une fois le test de connectivité terminé.
  --addr	Non	Spécifie l'adresse réseau. ossutil utilise une opération ping pour vérifier la connectivité réseau entre votre ordinateur local et l'adresse spécifiée. Valeur par défaut : www.aliyun.com.
  --upmode	Non	Méthode utilisée pour envoyer l'objet. Valeurs valides : normal (par défaut) : l'objet est envoyé via un envoi simple. append : l'objet est envoyé via un envoi par ajout. multipart : l'objet est envoyé via un envoi en plusieurs parties.

• Exemples

  • Vérifier la connectivité réseau en envoyant un objet aléatoire et en spécifiant l'adresse réseau

    Dans cet exemple, le bucket de destination est nommé examplebucket et l'adresse réseau à tester est aliyun.com. Commande d'exemple :

    ossutil probe --upload --bucketname examplebucket --addr aliyun.com

    Sortie d'exemple :

    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

  • Vérifier la connectivité réseau en envoyant un objet spécifique en mode d'envoi simple par défaut et supprimer l'objet envoyé une fois le test terminé

    Dans cet exemple, un fichier nommé example.txt situé dans le répertoire racine local est envoyé vers le bucket nommé examplebucket. Commande d'exemple :

    ossutil probe --upload example.txt --bucketname examplebucket 

    Sortie d'exemple :

    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

  • Vérifier la connectivité réseau en envoyant un objet spécifié en mode d'envoi par ajout et conserver l'objet envoyé dans le bucket une fois le test terminé

    Dans cet exemple, un fichier nommé example.txt situé dans le répertoire racine local est envoyé vers le bucket nommé examplebucket. Commande d'exemple :

    ossutil probe --upload example.txt --bucketname examplebucket --object example.txt --upmode append

    Sortie d'exemple :

    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

Vérifier la connectivité réseau en téléchargeant un objet via son URL et générer un rapport

ossutil vérifie la connectivité réseau entre le client local et un bucket en téléchargeant un objet depuis ce bucket via son URL.

• Syntaxe de la commande

  ossutil probe {--download} {--url http_url} [--addr=domain_name] [file_name]

  Le tableau suivant décrit les paramètres de la commande ci-dessus.

  Paramètre	Obligatoire	Description
  --download	Oui	Indique que le test de connectivité est effectué par téléchargement d'un objet.
  --url	Oui	URL de l'objet à télécharger. ossutil utilise cette URL pour télécharger l'objet dans un répertoire local. Si la liste de contrôle d'accès (ACL) de l'objet à télécharger est définie sur public-read, définissez ce paramètre sur l'URL de l'objet. Exemple : https://examplebucket.oss-cn-beijing.aliyuncs.com/example.jpg. Si la liste de contrôle d'accès (ACL) de l'objet à télécharger est privée, définissez ce paramètre sur l'URL signée de l'objet. L'URL doit être entourée de guillemets doubles (""). Exemple : "https://examplebucket.oss-cn-beijing.aliyuncs.com/example.jpg?Expires=1552015472&OSSAccessKeyId=TMP.5r9f1FV12y8_Qis6LUVmvoSCUSs7aboCCHtydQ0axN32Sn-UvyY3AAAwLAIUarYNLcO87AKMEcE5O3AoCFAQuRdZYyVFyqOW8QkGAN-bamUiQ&Signature=bIa4llbMbldrl7rwckr%2FXXvTtxw%3D".
  --addr	Non	Spécifie l'adresse réseau. ossutil utilise une opération ping pour vérifier la connectivité réseau entre votre ordinateur local et l'adresse spécifiée. Valeur par défaut : www.aliyun.com.
  file_name	Non	Chemin d'accès local de destination du téléchargement de l'objet. Si vous spécifiez uniquement le nom de l'objet sans indiquer de répertoire, l'objet est stocké sous le nom spécifié dans le répertoire d'installation d'ossutil. Si vous spécifiez uniquement un répertoire sans indiquer le nom de l'objet, l'objet est stocké sous son nom d'origine dans le répertoire spécifié. Si ce paramètre n'est pas spécifié, l'objet est stocké sous son nom d'origine dans le répertoire d'installation d'ossutil.

• Exemples

  • Vérifier la connectivité réseau en téléchargeant un objet spécifique via son URL et renommer l'objet

    Dans cet exemple, l'objet example.txt dont l'ACL est public-read est téléchargé depuis https://examplebucket.oss-cn-beijing.aliyuncs.com/example.txt vers un répertoire local et renommé en /localfile/test.txt. Commande d'exemple :

    ossutil probe --download --url https://examplebucket.oss-cn-beijing.aliyuncs.com/example.txt  /localfile/test.txt

    Sortie d'exemple :

    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
                                    

  • Vérifier la connectivité réseau en téléchargeant un objet via son URL et en spécifiant l'adresse réseau pour un test ping

    Dans cet exemple, l'objet example.txt dont l'ACL est public-read est téléchargé depuis https://examplebucket.oss-cn-beijing.aliyuncs.com/example.txt vers un répertoire local et l'adresse réseau pour le test ping est aliyun.com. Commande d'exemple :

    ossutil probe --download --url https://examplebucket.oss-cn-beijing.aliyuncs.com/example.txt --addr aliyun.com

    Sortie d'exemple :

    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                                

Vérifier la connectivité réseau en téléchargeant un objet spécifié et générer un rapport

ossutil vérifie la connectivité réseau entre le client local et un bucket en téléchargeant un objet depuis ce bucket.

• Syntaxe de la commande

  ossutil probe {--download} {--bucketname bucket_name} [--object object_name] [--addr domain_name] [file_name]

  Le tableau suivant décrit les paramètres de la commande ci-dessus.

  Paramètre	Obligatoire	Description
  --download	Oui	Indique que le test de connectivité est effectué par téléchargement d'un objet.
  --bucketname	Oui	Nom du bucket dont vous souhaitez vérifier la connexion.
  --object	Non	Nom de l'objet à télécharger. Si ce paramètre est indiqué dans la commande, ossutil télécharge l'objet spécifié dans un répertoire local. Sinon, ossutil génère un objet temporaire, l'envoie vers le bucket spécifié, puis le télécharge. Une fois le test de connectivité terminé, ossutil supprime l'objet temporaire du bucket.
  --addr	Non	Spécifie l'adresse réseau. ossutil utilise une opération ping pour vérifier la connectivité réseau entre votre ordinateur local et l'adresse spécifiée. Valeur par défaut : www.aliyun.com.
  file_name	Non	Chemin d'accès local de destination du téléchargement de l'objet. Si vous spécifiez uniquement le nom de l'objet sans indiquer de répertoire, l'objet est stocké sous le nom spécifié dans le répertoire d'installation d'ossutil. Si vous spécifiez uniquement un répertoire sans indiquer le nom de l'objet, l'objet est stocké sous son nom d'origine dans le répertoire spécifié. Si ce paramètre n'est pas spécifié, l'objet est stocké sous son nom d'origine dans le répertoire d'installation d'ossutil.

• Exemples

  • Vérifier la connectivité réseau en téléchargeant un objet et renommer l'objet

    Dans cet exemple, l'objet ossfolder/example.txt est téléchargé depuis le bucket examplebucket et renommé en /localfolder/text.txt. Commande d'exemple :

    ossutil probe --download --bucketname examplebucket --object ossfolder/example.txt /localfolder/text.txt

    Sortie d'exemple :

    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

  • Vérifier l'état de la connectivité réseau en téléchargeant un objet temporaire et en spécifiant l'adresse réseau pour un test ping

    Dans cet exemple, un objet temporaire est téléchargé depuis le bucket examplebucket. L'adresse réseau à tester est aliyun.com. Commande d'exemple :

    ossutil probe --download --bucketname examplebucket --addr aliyun.com

    Sortie d'exemple :

    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

Vérifier un élément spécifique

Utilisez la commande probe pour vérifier un élément spécifique, notamment l'état des liens symboliques locaux et les débits d'envoi et de réception. ossutil renvoie également les noms des liens symboliques défectueux et suggère un nombre optimal de tâches simultanées pour les opérations d'envoi et de réception, en fonction des résultats du test.

• Syntaxe de la commande

  ossutil probe {--probe-item item_value} {--bucketname bucket-name} [--object object_name][--parallel <value>][--part-size <value>][--runtime <value>]

  Le tableau suivant décrit les paramètres de la commande ci-dessus.

  Paramètre	Obligatoire	Description
  --probe-item	Oui	Élément à vérifier. Valeurs valides : cycle-symlink : ossutil vérifie la présence de liens symboliques défectueux dans le chemin d'accès local. upload-speed : ossutil vérifie le débit d'envoi. download-speed : ossutil vérifie le débit de réception. download-time : ossutil vérifie le temps nécessaire au téléchargement d'un objet.
  --bucketname	Oui lorsque la valeur de --probe-item n'est pas cycle-symlink	Nom du bucket dont vous souhaitez vérifier la connexion.
  --object	Oui lorsque la valeur de --probe-item est download-speed	Chemin d'accès de l'objet. L'objet doit exister. Nous vous recommandons de spécifier un objet d'une taille supérieure à 5 Mo. Exemple : ossfolder/example.txt.
  --parallel	Non	Nombre de tâches simultanées pour une opération sur un seul objet. Valeur par défaut : 1. Remarque Ce paramètre prend effet uniquement lorsque la valeur de --probe-item est download-time.
  --part-size	Non	Taille de la partie. Unité : octets. Par défaut, ossutil détermine la taille de la partie en fonction de la taille de l'objet. Valeurs valides : 1 à 9223372036854775807. Remarque Ce paramètre prend effet uniquement lorsque la valeur de --probe-item est download-time.
  --runtime	Non	Durée d'exécution maximale. Si cette durée est atteinte, l'exécution de la commande est interrompue. Remarque Ce paramètre prend effet uniquement lorsque la valeur de --probe-item est upload-speed ou download-speed.

• Exemples

  • Vérifier la présence de liens symboliques défectueux dans le répertoire localfolder du répertoire racine local

    Commande d'exemple :

    ossutil probe --probe-item cycle-symlink /root/localfolder

    Sortie d'exemple :

    Error: stat /root/localfolder/example.jpg: no such file or directory

    La sortie indique que le lien symbolique example.jpg est défectueux.

  • Vérifier le débit d'envoi

    Dans cet exemple, ossutil envoie un objet temporaire vers un bucket nommé examplebucket et renvoie un nombre recommandé de tâches d'envoi simultanées, en fonction des spécifications matérielles de l'appareil actuel et du débit d'envoi.

    Commande d'exemple :

    ossutil probe --probe-item upload-speed --bucketname examplebucket

    Sortie d'exemple :

    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)

    La sortie indique que le processeur de l'appareil dispose de deux cœurs, que le débit moyen maximal d'envoi est de 679,72 Ko/s et que le nombre recommandé de tâches d'envoi simultanées est de 2.

  • Vérifier le débit de réception

    Dans cet exemple, ossutil télécharge l'objet example.txt depuis le bucket examplebucket et recommande un nombre de téléchargements simultanés en fonction des performances matérielles et du débit de réception.

    Commande d'exemple :

    ossutil probe --probe-item download-speed --bucketname examplebucket --object example.txt

    Sortie d'exemple :

    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)

    La sortie indique que le processeur de l'appareil dispose de deux cœurs, que le débit moyen maximal de réception est de 12 564,45 Ko/s et que le nombre recommandé de tâches de réception simultanées est de 3.

  • Vérifier le débit de réception et spécifier la durée d'exécution maximale

    Dans cet exemple, ossutil télécharge l'objet example.zip depuis le bucket examplebucket et renvoie un nombre recommandé de tâches de réception simultanées, en fonction des performances matérielles et du débit de réception, avec une durée d'exécution maximale spécifiée.

    ossutil probe --probe-item download-speed --bucketname examplebucket --object  example.zip --runtime 2

    Sortie d'exemple :

    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

  • Vérifier le temps nécessaire à l'achèvement d'une tâche de téléchargement

    Dans cet exemple, ossutil télécharge l'objet example.txt depuis le bucket examplebucket et renvoie le temps nécessaire à l'achèvement de la tâche de téléchargement. Commande d'exemple :

    ossutil probe --probe-item download-time --bucketname examplebucket --object example.txt

    Sortie d'exemple :

    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

  • Vérifier le temps nécessaire à l'achèvement d'une tâche de téléchargement et spécifier la taille de la partie

    Dans cet exemple, ossutil télécharge l'objet example.zip depuis le bucket examplebucket en utilisant la taille de partie spécifiée et renvoie le temps nécessaire à l'achèvement de la tâche de téléchargement.

    ossutil probe --probe-item download-time --bucketname examplebucket --object example.zip --part-size 10000000

    Sortie d'exemple :

    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

  • Vérifier le temps nécessaire à l'achèvement d'une tâche de téléchargement et configurer le niveau de simultanéité

    Dans cet exemple, ossutil télécharge l'objet example.zip depuis le bucket examplebucket en utilisant la taille de partie spécifiée et renvoie le temps nécessaire à l'achèvement de la tâche de téléchargement.

    ossutil probe --probe-item download-time --bucketname examplebucket --object example.zip --parallel 3

    Sortie d'exemple :

    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