Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
pcluster export-cluster-logs
Exportez les journaux du cluster vers une tar.gz
archive locale en les faisant passer par un compartiment Amazon S3.
pcluster export-cluster-logs [-h] --cluster-name
CLUSTER_NAME
[--bucketBUCKET_NAME
] [--bucket-prefixBUCKET_PREFIX
] [--debug] [--end-timeEND_TIME
] [--filtersFILTER
[FILTER
...]] [--keep-s3-objectsKEEP_S3_OBJECTS
] [--output-fileOUTPUT_FILE
] [--regionREGION
] [--start-timeSTART_TIME
]
Note
La export-cluster-logs
commande attend que CloudWatch Logs termine l'exportation des journaux. On s'attend donc à ce qu'elle passe un certain temps sans aucune sortie.
Arguments nommés
-h, --help
-
Affiche le texte d'aide pour
pcluster export-cluster-logs
. --bucket
BUCKET_NAME
-
Spécifie le nom du compartiment Amazon S3 vers lequel exporter les données des journaux du cluster. Il doit se trouver dans la même région que le cluster.
Note
-
Vous devez ajouter des autorisations à la politique du compartiment Amazon S3 pour accorder CloudWatch l'accès. Pour plus d'informations, consultez la section Définir des autorisations sur un compartiment Amazon S3 dans le Guide de l'utilisateur CloudWatch des journaux.
-
À partir de AWS ParallelCluster la version 3.12.0, l'
--bucket
option est facultative. Si l'option n'est pas spécifiée, soit le compartiment AWS ParallelCluster régional par défaut (parallelcluster-hash-v1-DO-NOT-DELETE
) sera utilisé, soit si le compartiment Amazon S3 pointé parCustomS3Bucket
est spécifié dans la configuration du cluster, il sera utilisé. Si vous ne spécifiez pas--bucket
cette option et que vous utilisez le AWS ParallelCluster compartiment par défaut, vous ne pouvez pas exporter les journaux vers leparallelcluster/
dossier, car il s'agit d'un dossier protégé réservé à un usage interne.
Important
Si le bucket AWS ParallelCluster par défaut est utilisé, pcluster se chargera de configurer la politique du bucket. Si vous avez personnalisé la politique de compartiment puis effectuez une mise à niveau vers la AWS ParallelCluster version 3.12.0, la politique de compartiment sera remplacée et vous devrez réappliquer vos modifications.
-
--cluster-name, -n
CLUSTER_NAME
-
Spécifie le nom du cluster.
--bucket-prefix
BUCKET_PREFIX
-
Spécifie le chemin dans le compartiment Amazon S3 où les données des journaux exportés doivent être stockées.
Par défaut, le préfixe du bucket est :
cluster-name
-logs-202209061743
.tar.gz
est un exemple de202209061743
%Y%m%d%H%M
format de l'heure.Note
À partir de AWS ParallelCluster la version 3.12.0, si vous ne spécifiez pas l'
--bucket
option et que vous utilisez le AWS ParallelCluster bucket par défaut, vous ne pouvez pas exporter les journaux vers leparallelcluster/
dossier, car il s'agit d'un dossier protégé réservé à un usage interne. --debug
-
Active la journalisation du débogage.
--end-time
END_TIME
-
Spécifie la fin de la plage de temps pour collecter les événements du journal, exprimée au format ISO 8601 (
YYYY-MM-DDThh:mm:ssZ
par exemple2021-01-01T20:00:00Z
'). Les événements dont l'horodatage est égal ou supérieur à cette heure ne sont pas inclus. Les éléments temporels (par exemple les minutes et les secondes) peuvent être omis. La valeur par défaut est l'heure actuelle. --filters
FILTER
[FILTER
...]-
Spécifie les filtres pour le journal. Format :
Name=a,Values=1 Name=b,Values=2,3
. Les filtres pris en charge sont les suivants :private-dns-name
-
Spécifie la forme abrégée du DNS nom privé de l'instance (par exemple
ip-10-0-0-101
). node-type
-
Spécifie le type de nœud, la seule valeur acceptée pour ce filtre est
HeadNode
.
--keep-s3-objects
KEEP_S3_OBJECTS
-
Dans
true
ce cas, les objets exportés exportés vers Amazon S3 sont conservés. (La valeur par défaut estfalse
.) --output-file
OUTPUT_FILE
-
Spécifie le chemin du fichier dans lequel enregistrer l'archive du journal. Si cela est fourni, les journaux sont enregistrés localement. Dans le cas contraire, ils sont chargés sur Amazon S3 et URL renvoyés dans la sortie. Par défaut, le téléchargement vers Amazon S3 est effectué.
--region, -r
REGION
-
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide de la variable d'
AWS_DEFAULT_REGION
environnement, duregion
paramètre de la[default]
section du~/.aws/config
fichier ou du--region
paramètre. --start-time
START_TIME
-
Spécifie le début de la plage horaire, exprimé au format ISO 8601 (
YYYY-MM-DDThh:mm:ssZ
par exemple2021-01-01T20:00:00Z
). Les événements du journal dont l'horodatage est égal à cette heure ou à une date ultérieure sont inclus. Si ce n'est pas spécifié, la valeur par défaut est l'heure à laquelle le cluster a été créé.
Exemple utilisant AWS ParallelCluster la version 3.1.4 :
$
pcluster export-cluster-logs --bucket
cluster-v3-bucket
-ncluster-v3
{ "url": "https://cluster-v3-bucket..." }