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-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]
--cluster-name CLUSTER_NAME
[--bucket BUCKET_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]
```
**nota**
O `export-cluster-logs` comando espera que o CloudWatch Logs conclua a exportação dos registros, portanto, espera-se que ele passe um período sem nenhuma saída.
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster export-cluster-logs`.
**--bucket *BUCKET\$1NAME***
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.
+ 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/S3ExportTasks.html#S3Permissions) 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 o bucket do Amazon S3 apontado por `CustomS3Bucket` estiver especificado na configuração do cluster, ele será usado. 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 ela é uma pasta protegida reservada para uso interno.
Se o bucket AWS ParallelCluster padrão for usado, o pcluster se encarregará de configurar a política do bucket. Se você personalizou a política do bucket e depois atualizou para a AWS ParallelCluster versão **3.12.0**, a política do bucket será substituída e você precisará reaplicar suas alterações.
**--cluster-name, -n *CLUSTER\$1NAME***
Especifica o nome do cluster.
**--bucket-prefix *BUCKET\$1PREFIX***
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`é um exemplo da hora em `%Y%m%d%H%M` formato.
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\$1TIME***
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\$1S3\$1OBJECTS***
Se for `true`, as exportações de objetos exportados para o Amazon S3 serão mantidas. (Padronizado como `false`.)
**--output-file *OUTPUT\$1FILE***
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\$1TIME***
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..."
}
```
## Não é possível recuperar os registros?
Se você não conseguir recuperar os registros usando o `export-cluster-logs` comando, faça o seguinte:
+ Recupere os registros manualmente do grupo de CloudWatch registros do cluster.
+ Se o grupo de registros estiver vazio, faça o SSH nos nós do cluster e recupere os registros listados em. [Solução de problemas de inicialização do nó](troubleshooting-v3-scaling-issues.md#troubleshooting-v3-node-init)
+ Se os nós do cluster não estiverem acessíveis porque o cluster falhou na criação, recrie o cluster com a opção `--rollback-on-failure false` e recupere os registros dos nós.