pcluster export-cluster-logs

Exporta os logs do cluster para um arquivamento local tar.gz passando por um bucket do Amazon S3.

pcluster export-cluster-logs [-h]
                 --bucket BUCKET_NAME
                 --cluster-name CLUSTER_NAME 
                [--bucket-prefix BUCKET_PREFIX]
                [--debug]
                [--end-time END_TIME]
                [--filters FILTER [FILTER ...]]
                [--keep-s3-objects KEEP_S3_OBJECTS]
                [--output-file OUTPUT_FILE]
                [--region REGION]
                [--start-time START_TIME]

Argumentos nomeados

-h, --help

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

--bucket BUCKET_NAME

Especifica o nome do bucket do Amazon S3 para o qual exportar dados de logs de cluster. Deve estar na mesma região do cluster.

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.

--cluster-name, -n CLUSTER_NAME

Especifica o nome do cluster.

--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 é:

cluster-name-logs-202209061743.tar.gz

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

--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.

--filters FILTER [FILTER ...]

Especifica filtros para o log. Formato: Name=a,Values=1 Name=b,Values=2,3. Filtros compatíveis para:

private-dns-name

Especifica a forma abreviada do nome DNS privado da instância (por exemplo, ip-10-0-0-101).

node-type

Especifica o tipo de nó, o único valor aceito para esse filtro é HeadNode.

--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-cluster-logs --bucket cluster-v3-bucket -n cluster-v3
{
  "url": "https://cluster-v3-bucket..."
}