pcluster export-image-logs - AWS ParallelCluster
Argumentos nomeados

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

pcluster export-image-logs

Exporta os logs da pilha do construtor de imagens para um arquivo tar.gz local passando por um bucket do Amazon S3.

pcluster export-image-logs [-h]
                 --image-id IMAGE_ID
                [--bucket BUCKET]
                [--bucket-prefix BUCKET_PREFIX]
                [--debug]                         
                [--end-time END_TIME]
                [--keep-s3-objects KEEP_S3_OBJECTS]
                [--output-file OUTPUT_FILE]
                [--region REGION]
                [--start-time START_TIME]
nota

O export-image-logs comando espera que o CloudWatch Logs conclua a exportação dos registros, portanto, espera-se que passe um período sem nenhuma saída.

Argumentos nomeados

-h, --help

Mostra o texto de ajuda para pcluster export-image-logs.

--bucket BUCKET_NAME

Especifica o nome do bucket do Amazon S3 para o qual exportar logs criação de imagem. Deve estar na mesma região da imagem.

nota

  • Você deve adicionar permissões à política de bucket do Amazon S3 para conceder CloudWatch acesso. Para obter mais informações, consulte Definir permissões em um bucket do Amazon S3 no Guia do usuário de CloudWatch registros.

  • A partir da AWS ParallelCluster versão 3.12.0, a --bucket opção é opcional. Se a opção não for especificada, o bucket padrão AWS ParallelCluster regional (parallelcluster-hash-v1-DO-NOT-DELETE) será usado ou, se CustomS3Bucket for especificado na configuração da imagem, ele será usado.

Importante

Se o bucket AWS ParallelCluster padrão for usado, o pcluster se encarregará de configurar a política do bucket. Se você personalizar a política de bucket antes de atualizar para a AWS ParallelCluster versão 3.12.0, a política de bucket será substituída e você precisará reaplicar as alterações.

--image-id, -i IMAGE_ID

O ID da imagem cujos logs serão exportados.

--bucket-prefix BUCKET_PREFIX

Especifica o caminho no bucket do Amazon S3 para o qual os dados de log exportados devem ser armazenados.

Por padrão, o prefixo do bucket é:

ami-id-logs-202209061743.tar.gz

202209061743 é a hora atual no formato %Y%m%d%H%M.

nota

A partir da AWS ParallelCluster versão 3.12.0, se você não especificar a --bucket opção e usar o AWS ParallelCluster bucket padrão, não poderá exportar registros para a parallelcluster/ pasta, pois é uma pasta protegida reservada para uso interno.

--debug

Habilita o log de depuração.

--end-time END_TIME

Especifica o final do intervalo de tempo para coletar eventos de log, expresso no formato ISO 8601 (YYYY-MM-DDThh:mm:ssZ, por exemplo 2021-01-01T20:00:00Z'). Eventos com uma marca de data/hora igual ou posterior a esse horário não estão incluídos. Elementos de tempo (por exemplo, minutos e segundos) podem ser omitidos. O valor padrão é o horário atual.

--keep-s3-objects KEEP_S3_OBJECTS

Se for true, as exportações de objetos exportados para o Amazon S3 serão mantidas. (Padronizado como false.)

--output-file OUTPUT_FILE

Especifica o caminho do arquivo onde será salvo o arquivamento de log. Se isso for fornecido, os logs serão salvos localmente. Caso contrário, eles serão enviados para o Amazon S3 com o URL retornado na saída. O padrão é fazer upload para o Amazon S3.

--region, -r REGION

Especifica o a Região da AWS ser usado. O Região da AWS deve ser especificado usando a variável de AWS_DEFAULT_REGION ambiente, a region configuração na [default] seção do ~/.aws/config arquivo ou o --region parâmetro.

--start-time START_TIME

Especifica o início do intervalo de tempo, expresso no formato ISO 8601 (YYYY-MM-DDThh:mm:ssZ, por exemplo 2021-01-01T20:00:00Z). Eventos de log com uma marca de data/hora igual ou posterior a esse horário estão incluídos. Se não for especificado, o padrão é a hora em que o cluster foi criado.

Exemplo usando a AWS ParallelCluster versão 3.1.4:

$ pcluster export-image-logs --bucket image-v3-bucket --image-id ami-1234abcd5678efgh
{
  "url": "https://image-v3-bucket..."
}