View a markdown version of this page

pcluster export-cluster-logs - AWS ParallelCluster
Argomenti denominatiNon riesci a recuperare i log?

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

pcluster export-cluster-logs

Esporta i log del cluster in un tar.gz archivio locale passando attraverso un bucket 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

Il export-cluster-logs comando attende che CloudWatch Logs completi l'esportazione dei log, quindi è previsto un periodo di tempo senza alcun output.

Argomenti denominati

-h, --help

Mostra il testo di aiuto perpcluster export-cluster-logs.

--bucket BUCKET_NAME

Specifica il nome del bucket Amazon S3 in cui esportare i dati dei log del cluster. Deve trovarsi nella stessa regione del cluster.

Nota

  • È necessario aggiungere autorizzazioni alla policy del bucket Amazon S3 per concedere l'accesso. CloudWatch Per ulteriori informazioni, consulta Impostare le autorizzazioni su un bucket Amazon S3 nella Logs User Guide. CloudWatch

  • A partire dalla AWS ParallelCluster versione 3.12.0, l'opzione è opzionale. --bucket Se l'opzione non è specificata, verrà utilizzato il bucket predefinito AWS ParallelCluster regionale (parallelcluster-hash-v1-DO-NOT-DELETE) o se il bucket Amazon S3 a cui punta CustomS3Bucket è specificato nella configurazione del cluster, verrà utilizzato quello. Se non si specifica l'--bucketopzione e si utilizza il AWS ParallelCluster bucket predefinito, non è possibile esportare i log nella parallelcluster/ cartella, poiché si tratta di una cartella protetta riservata all'uso interno.

Importante

Se viene utilizzato il bucket AWS ParallelCluster predefinito, pcluster si occuperà della configurazione della policy del bucket. Se hai personalizzato la policy del bucket e poi esegui l'upgrade alla AWS ParallelCluster versione 3.12.0, la policy del bucket verrà sovrascritta e dovrai riapplicare le modifiche.

--cluster-name, -n CLUSTER_NAME

Specifica il nome del cluster.

--bucket-prefix BUCKET_PREFIX

Specifica il percorso nel bucket Amazon S3 in cui devono essere archiviati i dati di log esportati.

Per impostazione predefinita, il prefisso del bucket è:

cluster-name-logs-202209061743.tar.gz

202209061743è un esempio dell'ora in formato. %Y%m%d%H%M

Nota

A partire dalla AWS ParallelCluster versione 3.12.0, se non si specifica l'--bucketopzione e si utilizza il AWS ParallelCluster bucket predefinito, non è possibile esportare i log nella parallelcluster/ cartella, poiché si tratta di una cartella protetta riservata all'uso interno.

--debug

Abilita la registrazione del debug.

--end-time END_TIME

Specifica la fine dell'intervallo di tempo per la raccolta degli eventi di registro, espressa nel formato ISO 8601 (YYYY-MM-DDThh:mm:ssZad esempio '). 2021-01-01T20:00:00Z Gli eventi con un timestamp uguale o successivo a questo orario non sono inclusi. Gli elementi temporali (ad esempio minuti e secondi) possono essere omessi. Il valore predefinito è l'ora corrente.

--filters FILTER [FILTER ...]

Specifica i filtri per il registro. Formato:Name=a,Values=1 Name=b,Values=2,3. I filtri supportati sono:

private-dns-name

Specifica la forma abbreviata del nome DNS privato dell'istanza (ad es.ip-10-0-0-101).

node-type

Specifica il tipo di nodo, l'unico valore accettato per questo filtro è. HeadNode

--keep-s3-objects KEEP_S3_OBJECTS

In tal casotrue, gli oggetti esportati esportati in Amazon S3 vengono conservati. (Il valore predefinito è.) false

--output-file OUTPUT_FILE

Specifica il percorso del file in cui salvare l'archivio del registro. Se viene fornito, i log vengono salvati localmente. Altrimenti vengono caricati su Amazon S3 con l'URL restituito nell'output. L'impostazione predefinita è il caricamento su Amazon S3.

--region, -r REGION

Specifica il tipo Regione AWS da utilizzare. Regione AWS Deve essere specificato utilizzando la variabile di AWS_DEFAULT_REGION ambiente, l'regionimpostazione nella [default] sezione del ~/.aws/config file o il --region parametro.

--start-time START_TIME

Specifica l'inizio dell'intervallo di tempo, espresso nel formato ISO 8601 (ad YYYY-MM-DDThh:mm:ssZ esempio2021-01-01T20:00:00Z). Sono inclusi gli eventi di registro con un timestamp uguale a questa ora o successivo a questa ora. Se non è specificato, l'impostazione predefinita è l'ora di creazione del cluster.

Esempio di utilizzo AWS ParallelCluster della versione 3.1.4: 

$ pcluster export-cluster-logs --bucket cluster-v3-bucket -n cluster-v3
{
  "url": "https://cluster-v3-bucket..."
}

Non riesci a recuperare i log?

Se non riesci a recuperare i log utilizzando il export-cluster-logs comando, esegui una delle seguenti operazioni:

  • Recupera i log manualmente dal gruppo di CloudWatch log del cluster.

  • Se il gruppo di log è vuoto, esegui SSH nei nodi del cluster e recupera i log elencati in. Risoluzione dei problemi di inizializzazione dei nodi

  • Se i nodi del cluster non sono accessibili perché il cluster non è stato creato, ricrea il cluster con l'opzione --rollback-on-failure false e recupera i log dai nodi.