Object Storage Service:probe

Notas de uso

• Para verificar a largura de banda de upload, são necessárias as permissões oss:GetObject, oss:PutObject e oss:DeleteObject. Para verificar a largura de banda de download, é necessária a permissão oss:GetObject. Para mais informações, consulte Conceder uma política personalizada.

• No ossutil 1.6.16 e versões posteriores, use diretamente ossutil como nome do binário na linha de comando. Não é necessário atualizar o nome do binário com base no sistema operacional. Para versões do ossutil anteriores à 1.6.16, atualize o nome do binário conforme o sistema operacional. Para mais informações, consulte Guia de início rápido da ferramenta de linha de comando ossutil.

Notas de uso

Verificar o status da conexão de rede fazendo upload de um objeto e gerar um relatório

O ossutil verifica o status da conexão de rede entre o cliente local e um bucket ao fazer upload de um objeto para esse bucket.

• Sintaxe do comando

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

  A tabela a seguir descreve os parâmetros do comando acima.

  Parâmetro	Obrigatório	Descrição
  --upload	Sim	Indica que a detecção de conectividade será realizada mediante upload de um objeto.
  file_name	Não	Caminho completo do arquivo local a ser enviado para o bucket. Se este parâmetro não for especificado, o ossutil gera um objeto temporário e detecta a conectividade fazendo seu upload.
  --bucketname	Não	Nome do bucket cuja conexão você deseja verificar.
  --object	Não	Nome atribuído ao arquivo enviado. Se especificado no comando, o ossutil armazena o arquivo no bucket indicado usando esse nome. Caso contrário, o arquivo enviado é excluído após a conclusão da detecção de conectividade.
  --addr	Não	Define o endereço de rede. O ossutil usa uma operação ping para verificar a conectividade entre o computador local e o endereço especificado. Valor padrão: www.aliyun.com.
  --upmode	Não	Método utilizado para fazer upload do objeto. Valores válidos: normal (padrão): Upload simples do objeto. append: Upload por anexação do objeto. multipart: Upload multipartido do objeto.

• Exemplos

  • Verificar a conectividade de rede fazendo upload de um objeto aleatório e especificando o endereço de rede

    Neste exemplo, o bucket de destino chama-se examplebucket e o endereço de rede a ser verificado é aliyun.com. Comando de exemplo:

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

    Saída de exemplo:

    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

  • Verificar a conectividade fazendo upload de um objeto específico no modo de upload simples padrão e excluir o objeto após a detecção

    Neste cenário, um arquivo chamado example.txt no diretório raiz local é enviado para o bucket examplebucket. Comando de exemplo:

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

    Saída de exemplo:

    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

  • Verificar a conectividade fazendo upload de um objeto no modo append e mantê-lo no bucket após a detecção

    Aqui, o arquivo example.txt localizado na raiz local é enviado para o bucket examplebucket. Comando de exemplo:

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

    Saída de exemplo:

    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

Verificar a conectividade de rede baixando um objeto via URL e gerar um relatório

O ossutil testa a conectividade entre o cliente local e um bucket ao baixar um objeto usando sua URL.

• Sintaxe do comando

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

  A tabela abaixo detalha os parâmetros deste comando.

  Parâmetro	Obrigatório	Descrição
  --download	Sim	Determina que a verificação de conectividade ocorra por download de objeto.
  --url	Sim	URL do objeto a ser baixado. O ossutil utiliza essa URL para salvar o objeto em um diretório local. Se a ACL do objeto for public-read, defina este parâmetro com a URL direta do objeto. Exemplo: https://examplebucket.oss-cn-beijing.aliyuncs.com/example.jpg. Se a ACL for private, utilize a URL assinada do objeto. A URL deve estar entre aspas duplas (""). Exemplo: "https://examplebucket.oss-cn-beijing.aliyuncs.com/example.jpg?Expires=1552015472&OSSAccessKeyId=TMP.5r9f1FV12y8_Qis6LUVmvoSCUSs7aboCCHtydQ0axN32Sn-UvyY3AAAwLAIUarYNLcO87AKMEcE5O3AoCFAQuRdZYyVFyqOW8QkGAN-bamUiQ&Signature=bIa4llbMbldrl7rwckr%2FXXvTtxw%3D".
  --addr	Não	Especifica o endereço de rede. O ossutil executa um ping para testar a conectividade entre o computador local e o endereço informado. Valor padrão: www.aliyun.com.
  file_name	Não	Caminho local onde o objeto será salvo. Se apenas o nome do objeto for fornecido (sem diretório), ele será salvo com esse nome no diretório de instalação do ossutil. Se apenas o diretório for informado (sem nome de objeto), o arquivo manterá seu nome original no diretório especificado. Se o parâmetro for omitido, o objeto será salvo com o nome original no diretório de instalação do ossutil.

• Exemplos

  • Verificar conectividade baixando um objeto específico via URL e renomeá-lo

    Neste caso, o objeto example.txt com ACL public-read é baixado de https://examplebucket.oss-cn-beijing.aliyuncs.com/example.txt para um diretório local e renomeado como /localfile/test.txt. Comando de exemplo:

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

    Saída de exemplo:

    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
                                    

  • Testar conectividade baixando um objeto via URL e definindo um endereço para teste de ping

    Aqui, baixa-se o objeto example.txt (ACL public-read) de https://examplebucket.oss-cn-beijing.aliyuncs.com/example.txt para um diretório local, utilizando aliyun.com como endereço para o teste de ping. Comando de exemplo:

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

    Saída de exemplo:

    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                                

Verificar conectividade baixando um objeto especificado e gerar um relatório

O ossutil valida a conexão entre o cliente local e um bucket realizando o download de um objeto.

• Sintaxe do comando

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

  Os parâmetros deste comando estão descritos na tabela seguinte.

  Parâmetro	Obrigatório	Descrição
  --download	Sim	Define que a verificação de conectividade será feita via download.
  --bucketname	Sim	Nome do bucket alvo da verificação de conexão.
  --object	Não	Nome do objeto a ser baixado. Se especificado, o ossutil baixa esse objeto para o diretório local. Se omitido, o ossutil gera um objeto temporário, faz seu upload para o bucket e depois o baixa. Após a verificação, o objeto temporário é removido do bucket.
  --addr	Não	Endereço de rede para teste. O ossutil realiza um ping para validar a conectividade entre o computador local e o endereço indicado. Valor padrão: www.aliyun.com.
  file_name	Não	Destino local para o download do objeto. Informando apenas o nome do arquivo (sem diretório), ele será salvo no diretório de instalação do ossutil. Informando apenas o diretório (sem nome de arquivo), o objeto mantém seu nome original no local especificado. Sem especificação deste parâmetro, o objeto é salvo com o nome original no diretório de instalação do ossutil.

• Exemplos

  • Verificar conectividade baixando um objeto e renomeando-o

    Neste exemplo, o objeto ossfolder/example.txt é baixado do bucket examplebucket e salvo como /localfolder/text.txt. Comando de exemplo:

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

    Saída de exemplo:

    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

  • Verificar o status da conexão baixando um objeto temporário e definindo endereço para ping

    Aqui, um objeto temporário é baixado do bucket examplebucket. O endereço de rede verificado é aliyun.com. Comando de exemplo:

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

    Saída de exemplo:

    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

Verificar um item específico

Use o comando probe para inspecionar itens específicos, como o status de links simbólicos locais e as larguras de banda de upload e download. O ossutil também lista links simbólicos anormais e sugere um número ideal de tarefas simultâneas com base nos resultados.

• Sintaxe do comando

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

  A tabela a seguir explica os parâmetros disponíveis.

  Parâmetro	Obrigatório	Descrição
  --probe-item	Sim	Item a ser verificado. Valores válidos: cycle-symlink: Verifica a existência de links simbólicos anormais no caminho local. upload-speed: Mede a largura de banda de upload. download-speed: Mede a largura de banda de download. download-time: Calcula o tempo necessário para baixar um objeto.
  --bucketname	Sim, quando o valor de --probe-item não for cycle-symlink	Nome do bucket cuja conexão será testada.
  --object	Sim, quando o valor de --probe-item for download-speed	Caminho do objeto. O objeto deve existir. Recomenda-se usar um objeto maior que 5 MB. Exemplo: ossfolder/example.txt.
  --parallel	Não	Número de tarefas simultâneas para operação em um único objeto. Valor padrão: 1. Nota Este parâmetro só tem efeito quando --probe-item for download-time.
  --part-size	Não	Tamanho da parte. Unidade: bytes. Por padrão, o ossutil define esse tamanho com base no tamanho do objeto. Valores válidos: 1 a 9223372036854775807. Nota Este parâmetro só se aplica quando --probe-item for download-time.
  --runtime	Não	Tempo máximo de execução. Ao atingir esse limite, a execução do comando é interrompida. Nota Este parâmetro é válido apenas se --probe-item for upload-speed ou download-speed.

• Exemplos

  • Verificar links simbólicos anormais no diretório localfolder dentro da raiz local

    Comando de exemplo:

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

    Saída de exemplo:

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

    A saída indica que o link simbólico example.jpg está anormal.

  • Verificar a largura de banda de upload

    Neste cenário, o ossutil envia um objeto temporário para o bucket examplebucket e sugere um número de tarefas simultâneas de upload baseado nas especificações de hardware e na largura de banda disponível.

    Comando de exemplo:

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

    Saída de exemplo:

    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)

    A saída mostra que a CPU possui dois núcleos, a velocidade média máxima de upload é 679,72 KB/s e o número recomendado de tarefas simultâneas é 2.

  • Verificar a largura de banda de download

    Aqui, o ossutil baixa o objeto example.txt do bucket examplebucket e recomenda a simultaneidade ideal baseada no desempenho do hardware e na largura de banda.

    Comando de exemplo:

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

    Saída de exemplo:

    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)

    A saída indica CPU com dois núcleos, velocidade média máxima de download de 12.564,45 KB/s e recomendação de 3 tarefas simultâneas.

  • Verificar a largura de banda de download definindo tempo máximo de execução

    Neste exemplo, o ossutil baixa o objeto example.zip do bucket examplebucket e retorna a recomendação de tarefas simultâneas considerando o hardware e a largura de banda, respeitando um tempo limite de execução.

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

    Saída de exemplo:

    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

  • Verificar o tempo necessário para concluir um download

    Neste caso, o ossutil baixa o objeto example.txt do bucket examplebucket e informa o tempo total da operação. Comando de exemplo:

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

    Saída de exemplo:

    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

  • Verificar o tempo de download especificando o tamanho da parte

    Aqui, o ossutil baixa o objeto example.zip do bucket examplebucket usando um tamanho de parte definido e relata o tempo gasto.

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

    Saída de exemplo:

    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

  • Verificar o tempo de download configurando o nível de simultaneidade

    Neste exemplo, o ossutil baixa o objeto example.zip do bucket examplebucket com base na simultaneidade especificada e informa o tempo necessário para a conclusão.

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

    Saída de exemplo:

    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