本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# `pcluster export-cluster-logs`
<a name="pcluster.export-cluster-logs-v3"></a>

透過傳遞 Amazon S3 儲存貯體，將叢集的日誌匯出至本機`tar.gz`封存。

```
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}}]
```

**注意**  
`export-cluster-logs` 命令會等待 CloudWatch Logs 完成日誌的匯出，因此預期會經歷一段時間而沒有任何輸出。

## 具名引數
<a name="pcluster-v3.export-cluster-logs.namedargs"></a>

**-h, --help**  
顯示 的說明文字`pcluster export-cluster-logs`。

**--bucket {{BUCKET\_NAME}}**  
指定要匯出叢集日誌資料的 Amazon S3 儲存貯體名稱。它必須與叢集位於相同的區域。  
+ 您必須將許可新增至 Amazon S3 儲存貯體政策，才能授予 CloudWatch 存取。如需詳細資訊，請參閱《*CloudWatch Logs 使用者指南*》中的[設定 Amazon S3 儲存貯體的許可](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/S3ExportTasks.html#S3Permissions)。
+ 從 **3.12.0** AWS ParallelCluster 版開始， `--bucket`選項為**選用**。如果未指定 選項，則會使用區域預設儲存 AWS ParallelCluster 貯體 (`parallelcluster-hash-v1-DO-NOT-DELETE`)，或者如果叢集組態中指定了指向 `CustomS3Bucket` 的 Amazon S3 儲存貯體，則會使用該儲存貯體。如果您未指定 `--bucket`選項並使用預設儲存 AWS ParallelCluster 貯體，則無法將日誌匯出至 `parallelcluster/` 資料夾，因為它是保留供內部使用的受保護資料夾。
如果使用 AWS ParallelCluster 預設儲存貯體，則 pcluster 會負責設定儲存貯體政策。如果您自訂儲存貯體政策，然後升級至 AWS ParallelCluster **3.12.0** 版，則會覆寫儲存貯體政策，而且您需要重新套用變更。

**--cluster-name, -n {{CLUSTER\_NAME}}**  
指定叢集的名稱。

**--bucket-prefix {{BUCKET\_PREFIX}}**  
指定 Amazon S3 儲存貯體中要存放匯出日誌資料的路徑。  
根據預設，儲存貯體字首為：  

```
{{cluster-name}}-logs-{{202209061743}}.tar.gz
```
`{{202209061743}}` 是 `%Y%m%d%H%M` 格式的時間範例。  
從 **3.12.0** AWS ParallelCluster 版開始，如果您未指定 `--bucket`選項並使用預設 AWS ParallelCluster 儲存貯體，則無法將日誌匯出至 `parallelcluster/` 資料夾，因為它是保留供內部使用的受保護資料夾。

**--debug**  
啟用偵錯記錄。

**--end-time {{END\_TIME}}**  
指定收集日誌事件的時間範圍結束，以 ISO 8601 格式表示 (`YYYY-MM-DDThh:mm:ssZ`例如 `2021-01-01T20:00:00Z`')。時間戳記等於或晚於此時間的事件不會包含在內。可能會省略時間元素 （例如分鐘和秒）。預設值是目前時間。

**--filters {{FILTER}} [{{FILTER}} ...]**  
指定日誌的篩選條件。格式：`Name=a,Values=1 Name=b,Values=2,3`。支援的篩選條件包括：    
`private-dns-name`  
指定執行個體私有 DNS 名稱的簡短形式 （例如 `ip-10-0-0-101`)。  
`node-type`  
指定節點類型，此篩選條件唯一接受的值為 `HeadNode`。

**--keep-s3-objects {{KEEP\_S3\_OBJECTS}}**  
如果為 `true`，則會保留匯出至 Amazon S3 的物件。（預設為 `false`。)

**--output-file {{OUTPUT\_FILE}}**  
指定要儲存日誌封存的檔案路徑。如果提供此功能，則日誌會儲存在本機。否則，它們會以輸出中傳回的 URL 上傳至 Amazon S3。預設為上傳至 Amazon S3。

**--region, -r {{REGION}}**  
指定 AWS 區域 要使用的 。 AWS 區域 必須使用 `AWS_DEFAULT_REGION`環境變數、 `~/.aws/config` 檔案 `[default]`區段中的 `region`設定或 `--region` 參數來指定 。

**--start-time {{START\_TIME}}**  
指定時間範圍的開始，以 ISO 8601 格式表示 (`YYYY-MM-DDThh:mm:ssZ`例如 `2021-01-01T20:00:00Z`)。包含時間戳記等於此時間或晚於此時間的日誌事件。如果未指定，則預設為建立叢集的時間。

**使用 3.1.4 AWS ParallelCluster 版的範例：**

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

## 無法擷取日誌？
<a name="pcluster-v3.export-cluster-logs.retrieve-logs"></a>

如果您無法使用 `export-cluster-logs`命令擷取日誌，請執行下列其中一項操作：
+ 從叢集的 CloudWatch 日誌群組手動擷取日誌。
+ 如果日誌群組是空的，SSH 會進入叢集節點，並擷取 中列出的日誌[故障診斷節點初始化問題](troubleshooting-v3-scaling-issues.md#troubleshooting-v3-node-init)。
+ 如果叢集節點因為叢集無法建立而無法存取，請使用 選項重新建立叢集`--rollback-on-failure false`，並從節點擷取日誌。