Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# `pcluster export-cluster-logs`
Exportieren Sie die Protokolle des Clusters in ein lokales `tar.gz` Archiv, indem Sie sie durch einen Amazon S3 S3-Bucket leiten.
```
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]
```
**Anmerkung**
Der `export-cluster-logs` Befehl wartet darauf, dass CloudWatch Logs den Export der Logs abgeschlossen hat. Es ist also zu erwarten, dass es eine gewisse Zeit ohne Ausgabe geben wird.
## Benannte Argumente
**-h, --help**
Zeigt den Hilfetext für`pcluster export-cluster-logs`.
**--bucket *BUCKET\$1NAME***
Gibt den Namen des Amazon S3 S3-Buckets an, in den Cluster-Protokolldaten exportiert werden sollen. Er muss sich in derselben Region wie der Cluster befinden.
+ Sie müssen der Amazon S3 S3-Bucket-Richtlinie Berechtigungen hinzufügen, um CloudWatch Zugriff zu gewähren. Weitere Informationen finden Sie unter [Berechtigungen für einen Amazon S3 S3-Bucket festlegen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/S3ExportTasks.html#S3Permissions) im *CloudWatch Logs-Benutzerhandbuch*.
+ **Ab AWS ParallelCluster Version **3.12.0** ist `--bucket` diese Option optional.** Wenn die Option nicht angegeben ist, wird entweder der AWS ParallelCluster regionale Standard-Bucket (`parallelcluster-hash-v1-DO-NOT-DELETE`) verwendet, oder wenn der Amazon S3 S3-Bucket, auf den verwiesen wird, in der Cluster-Konfiguration angegeben `CustomS3Bucket` ist, wird dieser verwendet. Wenn Sie die `--bucket` Option nicht angeben und den AWS ParallelCluster Standard-Bucket verwenden, können Sie keine Protokolle in den `parallelcluster/` Ordner exportieren, da es sich um einen geschützten Ordner handelt, der für den internen Gebrauch reserviert ist.
Wenn der AWS ParallelCluster Standard-Bucket verwendet wird, kümmert sich pcluster um die Konfiguration der Bucket-Richtlinie. Wenn Sie die Bucket-Richtlinie angepasst haben und dann auf AWS ParallelCluster Version **3.12.0** aktualisieren, wird die Bucket-Richtlinie außer Kraft gesetzt und Sie müssen Ihre Änderungen erneut anwenden.
**--cluster-name, -n *CLUSTER\$1NAME***
Gibt den Namen des Clusters an.
**--bucket-prefix *BUCKET\$1PREFIX***
Gibt den Pfad im Amazon S3 S3-Bucket an, in dem exportierte Protokolldaten gespeichert werden sollen.
Standardmäßig lautet das Bucket-Präfix:
```
cluster-name-logs-202209061743.tar.gz
```
`202209061743`ist ein Beispiel für die Uhrzeit im `%Y%m%d%H%M` Format.
Ab AWS ParallelCluster Version **3.12.0** können Sie keine Protokolle in den Ordner exportieren, wenn Sie die `--bucket` Option nicht angeben und den AWS ParallelCluster Standard-Bucket verwenden, da es sich um einen geschützten `parallelcluster/` Ordner handelt, der für den internen Gebrauch reserviert ist.
**--debug**
Aktiviert die Debug-Protokollierung.
**--end-time *END\$1TIME***
Gibt das Ende des Zeitbereichs für die Erfassung von Protokollereignissen an, ausgedrückt im ISO 8601-Format (`YYYY-MM-DDThh:mm:ssZ`z. B. `2021-01-01T20:00:00Z` '). Ereignisse mit einem Zeitstempel, der diesem Zeitpunkt entspricht oder später liegt, sind nicht enthalten. Zeitelemente (z. B. Minuten und Sekunden) können weggelassen werden. Der Standardwert ist die aktuelle Zeit.
**--filters *FILTER* [*FILTER* ...]**
Definiert Filter für das Protokoll. Format:`Name=a,Values=1 Name=b,Values=2,3`. Unterstützte Filter sind:
`private-dns-name`
Gibt die Kurzform des privaten DNS-Namens der Instanz an (z. B.`ip-10-0-0-101`).
`node-type`
Gibt den Knotentyp an, der einzig akzeptierte Wert für diesen Filter ist`HeadNode`.
**--keep-s3-objects *KEEP\$1S3\$1OBJECTS***
Falls`true`, werden die exportierten Objekte, die nach Amazon S3 exportiert werden, beibehalten. (Die Standardeinstellung ist`false`.)
**--output-file *OUTPUT\$1FILE***
Gibt den Dateipfad an, in dem das Log-Archiv gespeichert werden soll. Wenn dies angegeben ist, werden die Protokolle lokal gespeichert. Andernfalls werden sie mit der in der Ausgabe zurückgegebenen URL auf Amazon S3 hochgeladen. Standardmäßig wird auf Amazon S3 hochgeladen.
**--region, -r *REGION***
Gibt den AWS-Region zu verwendenden an. Der AWS-Region muss mithilfe der `AWS_DEFAULT_REGION` Umgebungsvariablen, der `region` Einstellung im `[default]` Abschnitt der `~/.aws/config` Datei oder des `--region` Parameters angegeben werden.
**--start-time *START\$1TIME***
Gibt den Beginn des Zeitbereichs an, ausgedrückt im ISO 8601-Format (zum `YYYY-MM-DDThh:mm:ssZ` Beispiel`2021-01-01T20:00:00Z`). Protokollereignisse mit einem Zeitstempel, der diesem Zeitpunkt oder einem späteren Zeitpunkt entspricht, sind enthalten. Wenn nicht angegeben, ist die Standardeinstellung die Uhrzeit, zu der der Cluster erstellt wurde.
**Beispiel mit AWS ParallelCluster Version 3.1.4:**
```
$ pcluster export-cluster-logs --bucket cluster-v3-bucket -n cluster-v3
{
"url": "https://cluster-v3-bucket..."
}
```
## Die Protokolle können nicht abgerufen werden?
Wenn Sie die Protokolle nicht mit dem `export-cluster-logs` Befehl abrufen können, führen Sie einen der folgenden Schritte aus:
+ Rufen Sie die Protokolle manuell aus der CloudWatch Protokollgruppe des Clusters ab.
+ Wenn die Protokollgruppe leer ist, stellen Sie eine SSH-Verbindung zu den Clusterknoten her und rufen Sie die unter aufgeführten Protokolle ab. [Behebung von Problemen bei der Knoteninitialisierung](troubleshooting-v3-scaling-issues.md#troubleshooting-v3-node-init)
+ Wenn auf Clusterknoten nicht zugegriffen werden kann, weil der Cluster nicht erstellt werden konnte, erstellen Sie den Cluster mit der Option neu `--rollback-on-failure false` und rufen Sie die Protokolle von den Knoten ab.