Run the probe command and display probe results - Object Storage Service

Este tema describe cómo usar el comando probe para detectar anomalías en la conectividad de red entre el cliente local y Object Storage Service (OSS). También permite comprobar el ancho de banda de carga y descarga, así como obtener el estado de los enlaces simbólicos locales.

Notas de uso

Para comprobar el ancho de banda de carga, necesita los permisos oss:GetObject, oss:PutObject y oss:DeleteObject. Para comprobar el ancho de banda de descarga, requiere el permiso oss:GetObject. Para más información, consulte Grant a custom policy.
En ossutil 1.6.16 y versiones posteriores, utilice directamente ossutil como nombre del binario en la línea de comandos. No es necesario modificar el nombre del binario según el sistema operativo. En versiones anteriores a la 1.6.16, sí debe ajustar el nombre del binario de acuerdo con su sistema operativo. Para más información, consulte ossutil command reference.

Notas de uso

Ejecute el comando probe para detectar anomalías en la conectividad de red entre el cliente local y OSS, y para comprobar el ancho de banda de carga y descarga. Este comando también sirve para verificar el estado de una gran cantidad de enlaces simbólicos antes de cargarlos.

Detección de anomalías de red

ossutil comprueba el estado de la conexión de red entre el cliente local y OSS mediante la carga o descarga de objetos. Si desea cargar o descargar objetos en una ubicación específica durante la detección, se recomienda especificar los nombres reales de dichos objetos. Si solo necesita detectar anomalías de red, ejecute el comando sin indicar nombres de objetos. En este caso, ossutil genera objetos temporales para probar la conectividad y los elimina al finalizar la comprobación.
Comprobación del ancho de banda de carga y descarga

Al ejecutar este comando para comprobar el ancho de banda de carga y descarga, OSS sugiere un número de tareas simultáneas basado en la CPU de sus dispositivos locales y en su ancho de banda de red. Utilice esta recomendación para aprovechar al máximo su ancho de banda.
Verificación del estado de los enlaces simbólicos locales

Cuando se cargan muchos enlaces simbólicos, el proceso se interrumpe si alguno presenta anomalías. Se recomienda verificar el estado de los enlaces simbólicos locales antes de cargarlos. Si detecta algún enlace defectuoso, corrija el problema antes de iniciar la carga.

Después de ejecutar el comando probe, consulte el procedimiento y el resultado de cada tarea de carga o descarga.

Detectar anomalías de red mediante la carga o descarga de objetos
- Una marca de verificación (√) indica que el resultado de la comprobación es positivo. Una cruz (×) señala un resultado negativo.
- Si la detección se completa correctamente, ossutil devuelve la información de la tarea de carga o descarga. Esta incluye el tamaño del objeto transferido, el tiempo empleado en la operación y la ubicación de destino o de origen.
- Si la detección falla, ossutil devuelve las causas o los códigos de error, los cuales le servirán para solucionar los problemas.
  
  Para más información sobre los códigos de error, consulte Error responses.
- Al finalizar la detección, ossutil crea un archivo de registro en el directorio de instalación con el formato logOssProbe+DetectionCompletionTime.log. Dicho archivo contiene información detallada sobre la ejecución del comando probe.
Comprobar un elemento específico

Cuando ejecuta el comando probe para comprobar el ancho de banda de carga y descarga o el estado de los enlaces simbólicos locales, ossutil proporciona los resultados de la comprobación junto con sugerencias.

Comprobar el estado de la conexión de red mediante la carga de un objeto y generar un informe

ossutil comprueba el estado de la conexión de red entre el cliente local y un bucket al cargar un objeto en dicho bucket.

Sintaxis del comando

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

A continuación se describen los parámetros del comando anterior.

Parámetro	Obligatorio	Descripción
--upload	Sí	Indica que la detección de conectividad se realiza mediante la carga de un objeto.
file_name	No	Ruta completa del archivo local que desea cargar en el bucket. Si omite este parámetro, ossutil genera un objeto temporal y detecta la conectividad al cargarlo.
--bucketname	No	Nombre del bucket cuya conexión desea comprobar.
--object	No	Nombre que asigna al archivo cargado. Si especifica este parámetro en el comando, ossutil almacena el archivo en el bucket indicado con ese nombre. Si lo omite, ossutil elimina el archivo cargado al terminar la detección de conectividad.
--addr	No	Dirección de red. ossutil utiliza una operación ping para comprobar la conectividad de red entre su computadora local y la dirección especificada. Valor predeterminado: `www.aliyun.com`.
--upmode	No	Método utilizado para cargar el objeto. Valores válidos: normal (predeterminado): el objeto se carga mediante carga simple. append: el objeto se carga mediante carga por anexión. multipart: el objeto se carga mediante carga multiparte.

Ejemplos

Comprobar la conectividad de red al cargar un objeto aleatorio y especificar la dirección de red

En este ejemplo, el bucket de destino se llama examplebucket y la dirección de red que se va a comprobar es aliyun.com. Comando de ejemplo:

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

Salida de ejemplo:

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

Comprobar la conectividad de red al cargar un objeto específico en modo de carga simple predeterminado y eliminarlo al finalizar la detección

En este ejemplo, se carga el archivo example.txt, ubicado en el directorio raíz local, al bucket llamado examplebucket. Comando de ejemplo:

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

Salida de ejemplo:

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

Comprobar la conectividad de red al cargar un objeto específico en modo de carga por anexión y conservarlo en el bucket después de la detección

En este ejemplo, se carga el archivo example.txt, ubicado en el directorio raíz local, al bucket llamado examplebucket. Comando de ejemplo:

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

Salida de ejemplo:

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

Comprobar la conectividad de red mediante la descarga de un objeto con su URL y generar un informe

ossutil comprueba la conectividad de red entre el cliente local y un bucket al descargar un objeto desde dicho bucket mediante su URL.

Sintaxis del comando

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

A continuación se describen los parámetros del comando anterior.

Parámetro	Obligatorio	Descripción
--download	Sí	Indica que la comprobación de conectividad se realiza mediante la descarga de un objeto.
--url	Sí	URL del objeto que desea descargar. ossutil utiliza esta URL para descargar el objeto a un directorio local. Si la ACL del objeto que desea descargar es public-read, establezca este parámetro con la URL del objeto. Ejemplo: `https://examplebucket.oss-cn-beijing.aliyuncs.com/example.jpg`. Si la ACL del objeto que desea descargar es private, establezca este parámetro con la URL firmada del objeto. La URL debe ir entre comillas dobles (""). Ejemplo: `"https://examplebucket.oss-cn-beijing.aliyuncs.com/example.jpg?Expires=1552015472&OSSAccessKeyId=TMP.5r9f1FV12y8_Qis6LUVmvoSCUSs7aboCCHtydQ0axN32Sn-UvyY3AAAwLAIUarYNLcO87AKMEcE5O3AoCFAQuRdZYyVFyqOW8QkGAN-bamUiQ&Signature=bIa4llbMbldrl7rwckr%2FXXvTtxw%3D"`.
--addr	No	Dirección de red. ossutil utiliza una operación ping para comprobar la conectividad de red entre su computadora local y la dirección especificada. Valor predeterminado: `www.aliyun.com`.
file_name	No	Ruta local donde se descargará el objeto. Si solo especifica el nombre del objeto sin indicar un directorio, este se almacena con dicho nombre en el directorio de instalación de ossutil. Si solo especifica un directorio sin indicar el nombre del objeto, este se almacena con su nombre original en el directorio indicado. Si omite este parámetro, el objeto se almacena con su nombre original en el directorio de instalación de ossutil.

Ejemplos

Comprobar la conectividad de red al descargar un objeto específico mediante su URL y cambiarle el nombre

En este ejemplo, el objeto example.txt, cuya ACL es public-read, se descarga desde https://examplebucket.oss-cn-beijing.aliyuncs.com/example.txt hacia un directorio local y se renombra como /localfile/test.txt. Comando de ejemplo:

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

Salida de ejemplo:

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

Comprobar la conectividad de red al descargar un objeto mediante su URL y especificar la dirección de red para una prueba ping

En este ejemplo, el objeto example.txt, cuya ACL es public-read, se descarga desde https://examplebucket.oss-cn-beijing.aliyuncs.com/example.txt hacia un directorio local. La dirección de red para la prueba ping es aliyun.com. Comando de ejemplo:

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

Salida de ejemplo:

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

Comprobar la conectividad de red mediante la descarga de un objeto específico y generar un informe

ossutil comprueba la conectividad de red entre el cliente local y un bucket al descargar un objeto desde dicho bucket.

Sintaxis del comando

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

A continuación se describen los parámetros del comando anterior.

Parámetro	Obligatorio	Descripción
--download	Sí	Indica que la comprobación de conectividad se realiza mediante la descarga de un objeto.
--bucketname	Sí	Nombre del bucket cuya conexión desea comprobar.
--object	No	Nombre del objeto que desea descargar. Si especifica este parámetro en el comando, ossutil descarga el objeto indicado a un directorio local. Si lo omite, ossutil genera un objeto temporal, lo carga en el bucket especificado y luego lo descarga. Al terminar la comprobación de conectividad, ossutil elimina el objeto temporal del bucket.
--addr	No	Dirección de red. ossutil utiliza una operación ping para comprobar la conectividad de red entre su computadora local y la dirección especificada. Valor predeterminado: `www.aliyun.com`.
file_name	No	Ruta local donde se descargará el objeto. Si solo especifica el nombre del objeto sin indicar un directorio, este se almacena con dicho nombre en el directorio de instalación de ossutil. Si solo especifica un directorio sin indicar el nombre del objeto, este se almacena con su nombre original en el directorio indicado. Si omite este parámetro, el objeto se almacena con su nombre original en el directorio de instalación de ossutil.

Ejemplos

Comprobar la conectividad de red al descargar un objeto y cambiarle el nombre

En este ejemplo, el objeto ossfolder/example.txt se descarga del bucket examplebucket y se renombra como /localfolder/text.txt. Comando de ejemplo:

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

Salida de ejemplo:

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

Comprobar el estado de la conectividad de red al descargar un objeto temporal y especificar la dirección de red para una prueba ping

En este ejemplo, se descarga un objeto temporal del bucket examplebucket. La dirección de red que se va a comprobar es aliyun.com. Comando de ejemplo:

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

Salida de ejemplo:

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

Comprobar un elemento específico

Ejecute el comando probe para comprobar elementos específicos, como el estado de los enlaces simbólicos locales y el ancho de banda de carga y descarga. Además, ossutil devuelve los nombres de los enlaces simbólicos anómalos y sugiere un número de tareas simultáneas para cargas y descargas según los resultados obtenidos.

Sintaxis del comando

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

A continuación se describen los parámetros del comando anterior.

Parámetro	Obligatorio	Descripción
--probe-item	Sí	Elemento que desea comprobar. Valores válidos: cycle-symlink: ossutil comprueba si existen enlaces simbólicos anómalos en la ruta local. upload-speed: ossutil comprueba el ancho de banda de carga. download-speed: ossutil comprueba el ancho de banda de descarga. download-time: ossutil comprueba el tiempo necesario para descargar un objeto.
--bucketname	Sí, cuando el valor de --probe-item no es `cycle-symlink`	Nombre del bucket cuya conexión desea comprobar.
--object	Sí, cuando el valor de --probe-item es `download-speed`	Ruta del objeto. El objeto debe existir. Se recomienda especificar un objeto cuyo tamaño supere los 5 MB. Ejemplo: `ossfolder/example.txt`.
--parallel	No	Número de tareas simultáneas para una operación sobre un solo objeto. Valor predeterminado: 1. Nota Este parámetro solo surte efecto cuando el valor de --probe-item es `download-time`.
--part-size	No	Tamaño de la parte, en bytes. De forma predeterminada, ossutil determina este tamaño según el tamaño del objeto. Valores válidos: de 1 a 9223372036854775807. Nota Este parámetro solo surte efecto cuando el valor de --probe-item es `download-time`.
--runtime	No	Tiempo máximo de ejecución. Si se alcanza este límite, la ejecución del comando se interrumpe. Nota Este parámetro solo surte efecto cuando el valor de --probe-item es `upload-speed` o `download-speed`.

Ejemplos

Comprobar si existen enlaces simbólicos anómalos en el directorio localfolder de la raíz local
Comando de ejemplo:
```
ossutil probe --probe-item cycle-symlink /root/localfolder
```
Salida de ejemplo:
```
Error: stat /root/localfolder/example.jpg: no such file or directory
```
La salida muestra que el enlace simbólico example.jpg es anómalo.
Comprobar el ancho de banda de carga

En este ejemplo, ossutil carga un objeto temporal en un bucket llamado examplebucket. Luego, devuelve un número recomendado de tareas de carga simultáneas según las especificaciones de hardware del dispositivo actual y el ancho de banda de carga.
Comando de ejemplo:
```
ossutil probe --probe-item upload-speed --bucketname examplebucket
```
Salida de ejemplo:
```
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 salida indica que la CPU del dispositivo tiene dos núcleos, que el ancho de banda promedio máximo de carga es de 679.72 KB/s y que se recomiendan 2 tareas de carga simultáneas.
Comprobar el ancho de banda de descarga

En este ejemplo, ossutil descarga el objeto example.txt del bucket examplebucket. Después, sugiere el número de descargas simultáneas según el rendimiento del hardware y el ancho de banda de descarga.
Comando de ejemplo:
```
ossutil probe --probe-item download-speed --bucketname examplebucket --object example.txt
```
Salida de ejemplo:
```
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 salida indica que la CPU del dispositivo tiene dos núcleos, que el ancho de banda promedio máximo de descarga es de 12,564.45 KB/s y que se recomiendan 3 tareas de descarga simultáneas.

Comprobar el ancho de banda de descarga y especificar el tiempo máximo de ejecución

En este ejemplo, ossutil descarga el objeto example.zip del bucket examplebucket. Devuelve un número recomendado de tareas de descarga simultáneas según el rendimiento del hardware y el ancho de banda, respetando el tiempo máximo de ejecución especificado.

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

Salida de ejemplo:

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

Comprobar el tiempo necesario para completar una tarea de descarga

En este ejemplo, ossutil descarga el objeto example.txt del bucket examplebucket y devuelve el tiempo necesario para completar la tarea de descarga. Comando de ejemplo:

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

Salida de ejemplo:

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

Comprobar el tiempo necesario para completar una tarea de descarga y especificar el tamaño de la parte

En este ejemplo, ossutil descarga el objeto example.zip del bucket examplebucket con el tamaño de parte especificado. Luego, devuelve el tiempo necesario para completar la tarea de descarga.

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

Salida de ejemplo:

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

Comprobar el tiempo necesario para completar una tarea de descarga y configurar el nivel de simultaneidad

En este ejemplo, ossutil descarga el objeto example.zip del bucket examplebucket con el tamaño de parte especificado. Después, devuelve el tiempo necesario para completar la tarea de descarga.

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

Salida de ejemplo:

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