pcluster export-cluster-logs

透過 Amazon S3 儲tar.gz存貯體將叢集的日誌匯出到本機存檔。

pcluster export-cluster-logs [-h]
                 --bucket BUCKET_NAME
                 --cluster-name CLUSTER_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]

命名參數

-h, --help

顯示的說明文字pcluster export-cluster-logs。

--bucket BUCKET_NAME

指定要將叢集日誌資料匯出至的 Amazon S3 儲存貯體的名稱。它必須與叢集位於相同的區域。

注意

您必須向 Amazon S3 儲存貯體政策新增許可才能授予 CloudWatch 存取權。如需詳細資訊，請參閱CloudWatch 日誌使用者指南中的在 Amazon S3 儲存貯體上設定許可。

--cluster-name, -n CLUSTER_NAME

指定叢集的名稱。

--bucket-prefix BUCKET_PREFIX

指定 Amazon S3 儲存貯體中要存放匯出日誌資料的路徑。

默認情況下，值區前綴是：

cluster-name-logs-202209061743.tar.gz

202209061743是以%Y%m%d%H%M格式表示的目前時間。

--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)。包含時間戳記等於此時間或晚於此時間的記錄事件。如果未指定，預設值是建立叢集的時間。

使用 AWS ParallelCluster 版本 3.1.4 的示例：

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