本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
pcluster export-cluster-logs
透過傳遞 Amazon S3 儲存貯體,將叢集的日誌匯出至本機tar.gz
封存。
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
]
注意
export-cluster-logs
命令會等待 CloudWatch Logs 完成日誌的匯出,因此預期會經歷一段時間而沒有任何輸出。
具名引數
-h, --help
-
顯示 的說明文字
pcluster export-cluster-logs
。 --bucket
BUCKET_NAME
-
指定要匯出叢集日誌資料的 Amazon S3 儲存貯體名稱。它必須與叢集位於相同的區域。
注意
-
您必須將許可新增至 Amazon S3 儲存貯體政策,才能授予 CloudWatch 存取權。如需詳細資訊,請參閱 CloudWatch 日誌使用者指南中的在 Amazon S3 儲存貯體上設定許可。
-
從 3.12.0 AWS ParallelCluster 版開始,
--bucket
選項為選用。如果未指定 選項,則會使用區域預設儲存貯體 AWS ParallelCluster (parallelcluster-hash-v1-DO-NOT-DELETE
),或者如果叢集組態中CustomS3Bucket
指定了指向 的 Amazon S3 儲存貯體,則會使用。如果您未指定--bucket
選項,且使用預設儲存 AWS ParallelCluster 貯體,則無法將日誌匯出至parallelcluster/
資料夾,因為這是保留供內部使用的受保護資料夾。
重要
如果使用 AWS ParallelCluster 預設儲存貯體,叢集會負責設定儲存貯體政策。如果您自訂儲存貯體政策,然後升級至 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
-
指定要儲存日誌封存的檔案路徑。如果提供此功能,則日誌會儲存在本機。否則,它們會上傳到 Amazon S3,並在輸出中URL傳回 。預設為上傳至 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
-ncluster-v3
{ "url": "https://cluster-v3-bucket..." }