本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
mon-describe-alarm-history
描述
擷取指定警示的歷史記錄。您可以依日期範圍或項目類型來篩選警示。如果您未指定警示名稱,Amazon 會 CloudWatch 傳回所有警示的歷史記錄。
注意
Amazon CloudWatch 保留活動和已刪除警報的歷史記錄兩週。
語法
mon-describe-alarm-history
[AlarmNames [
AlarmNames
...]] [--end-date value
] [--history-item-type value
]
[--start-date value
] [Common Options]
選項
名稱 | 描述 |
---|---|
|
警示的名稱,以空格分隔。如果您不指定警示名稱,此命令會傳回所有警示的歷史記錄。您也可以使用 類型:引數 有效值:長度為 1 到 255 個字元的任何字串。 預設:無 必要:否 |
|
歷史記錄的日期範圍結尾。 類型:日期 有效值:YYYY-MM-DD 格式的日期。 預設:當前日期。 必要:否 |
|
要擷取的日誌項目類型。在預設情況下會傳回所有類型。 類型:列舉 有效值: ConfigurationUpdate StateUpdate、或動作 預設:傳回所有類型。 必要:否 |
|
歷史記錄的日期範圍開頭。在預設情況下會延伸到所有可用的歷史記錄。 類型:日期 有效值:YYYY-MM-DD 格式的日期。 預設:所有可用的歷史記錄。 必要:否 |
常用選項
名稱 | 描述 |
---|---|
|
包含您 AWS 認證的檔案位置。您可以使用環境變數 類型:字串 有效值:檔案的有效路徑,包含存取金鑰 ID 和私密存取金鑰。 預設:使用環境變數 |
|
用於簽署請求的 EC2 憑證檔案位置。您可使用環境變數 類型:字串 有效值:由 Amazon EC2 或 AWS Identity and Access Management提供的 PEM 檔案的有效檔案路徑。 預設:使用環境變數 |
|
連線逾時值 (以秒為單位)。 類型:整數 有效值:任何正數。 預設:30 |
|
顯示分隔符號 (長) 結果時使用的分隔符號。 類型:字串 有效值:任何字串。 預設:逗號 (,) |
|
如果您要顯示表格式或分隔式結果,請包含欄標題。如果顯示 XML 結果,請從服務請求傳回 HTTP 標題 (如適用)。 類型:標記 有效值:如果存在,則顯示標題。 預設: |
|
將用於簽署請求的存取金鑰 ID,與私密金鑰搭配使用。此參數必須與私密金鑰搭配使用,否則會忽略該選項。所有要求都 CloudWatch 必須簽署,否則請求將被拒絕。 類型:字串 有效值:有效的存取金鑰 ID。 預設:無 |
|
將用於簽署請求的私有金鑰。使用公有/私有金鑰會導致 CLI 使用 SOAP。使用公有憑證和私有金鑰簽署請求。此參數必須與 類型:字串 有效值:有效 ASN.1 私有金鑰的路徑。 預設:無 |
|
該區域請求被導向。您可使用環境變數 類型:字串 有效值:任何 AWS 區域,例如 us-east-1。 預設:us-east-1,除非設定了 |
|
將用於簽署請求的私密存取金鑰,與存取金鑰 ID 搭配使用。此參數必須與 類型:字串 有效值:您的存取金鑰 ID。 預設:無 |
|
使用 (nil) 作為預留位置顯示空欄位,表示未請求此資料。 類型:標記 有效值:無 預設:預設不會顯示空欄位。 |
|
顯示 CLI 用來呼叫 AWS的 URL。 類型:標記 有效值:無 預設:false |
|
指定結果的顯示方式:在表格中、分隔符號 (長)、XML 或無輸出 (靜音)。 類型:標記 有效值:無 預設: |
|
用來聯絡的網址 CloudWatch。您可以使用環境變數 類型:字串 有效值:有效的 HTTP 或 HTTPS URL。 預設:使用 |
輸出
此命令會傳回一個表格,其中包含下列項目:
-
ALARM - 警示名稱。
-
TIMESTAMP - 時間戳記。
-
類型-事件的類型、其中一 ConfigurationUpdate個 StateUpdate 和動作。
-
SUMMARY - 人類可閱讀的歷史記錄事件摘要。
-
DATA - 事件的詳細資料 (機器可讀取的 JSON 格式)。此欄只出現在 --show-long 檢視中。
Amazon CloudWatch CLI 在標準錯誤上顯示錯誤。
範例
範例請求
此範例說明 my-alarm 警示的所有歷史記錄項目。
mon-describe-alarm-history--alarm-name my-alarm --headers
這是此命令的輸出範例。
ALARM TIMESTAMP TYPE SUMMARY my-alarm 2013-05-07T18:46:16.121Z Action Published a notification to arn:aws:sns:... my-alarm 2013-05-07T18:46:16.118Z StateUpdate Alarm updated from INSUFFICIENT_DATA to OK my-alarm 2013-05-07T18:46:07.362Z ConfigurationUpdate Alarm "my-alarm" created