本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
範例:計算詞彙的出現次數
日誌事件經常包含您想要計數,或是有關操作成功或失敗操作的重要訊息。例如,若指定的操作失敗,錯誤可能會發生且系統會將該錯誤記錄到日誌檔。您可能想要監控這些項目,以了解錯誤的趨勢。
在下例中,建立指標篩選條件來監控「Error」詞彙。政策已建立並新增至日誌群組 MyApp/message.log. CloudWatch Logs 會將資料點發佈至 MyApp/message.log 命名空間 ErrorCount 中的 CloudWatch 自訂指標,且每個包含錯誤的事件的值為「1」。如果事件不包含單字「Error」,則會發佈值 0。在 CloudWatch 主控台中製作此資料的圖表時,請務必使用總和統計。
建立指標篩選條件後,您可以在 CloudWatch 主控台中檢視指標。選取要檢視的指標時,請選取符合日誌群組名稱的指標命名空間。如需詳細資訊,請參閱檢視可用的指標。
使用 CloudWatch 主控台建立指標篩選條件
-
在 開啟 CloudWatch 主控台https://console.aws.amazon.com/cloudwatch/
。 -
在導覽窗格中,選擇 Log groups (日誌群組)。
-
選擇日誌群組的名稱。
選擇 Actions (動作) > Create metric filter (建立指標篩選條件)。
-
針對 Filter Pattern (篩選條件模式),輸入
Error
。注意
在 Filter Pattern (篩選條件模式) 中的所有項目都會區分大小寫。
-
(選用) 若要測試篩選條件模式,請在 Test Pattern (測試模式) 下方,輸入一個或多個日誌事件,用以測試模式。每個日誌事件都必須在一行內,因為 Log event messages (日誌事件訊息) 方塊中使用換行來分隔日誌事件。
-
選擇 Next (下一步),然後在 Assign metric (指派指標) 頁面上,針對 Filter Name (篩選條件名稱) 輸入
MyAppErrorCount
。 -
在 Metric Details (指標詳細資訊) 下的 Metric Namespace (指標命名空間) 中,輸入 MyNameSpace。
-
針對 Metric Name (指標名稱),輸入 ErrorCount。
確認 Metric Value (指標值) 為 1。這會指定針對每個包含「Error」的日誌事件計數以 1 的方式遞增。
針對 Default Value (預設值),輸入 0,然後選擇 Next (下一步)。
選擇 Create metric filter (建立指標篩選條件)。
使用 建立指標篩選條件 AWS CLI
在命令提示中,執行下列命令:
aws logs put-metric-filter \ --log-group-name MyApp/message.log \ --filter-name MyAppErrorCount \ --filter-pattern 'Error' \ --metric-transformations \ metricName=ErrorCount,metricNamespace=MyNamespace,metricValue=1,defaultValue=0
您可以透過張貼在訊息中包含「錯誤」單字的事件來測試這個新政策。
使用 發佈事件 AWS CLI
畫面出現命令提示時,執行下列 命令。請注意,模式會區分大小寫。
aws logs put-log-events \ --log-group-name MyApp/access.log --log-stream-name TestStream1 \ --log-events \ timestamp=1394793518000,message="This message contains an Error" \ timestamp=1394793528000,message="This message also contains an Error"