使用 CloudWatch 指標監控使用量

PDFRSS

您可以使用本節中的資料表來檢閱 Amazon CloudWatch Logs 每分鐘傳送至 Amazon CloudWatch 的指標。

CloudWatch Logs 指標

AWS/Logs 命名空間包含下列指標。

指標	描述
CallCount	在您的帳戶中執行的特定 API 操作數目。 CallCount 是 CloudWatch Logs 服務用量指標。如需詳細資訊，請參閱 CloudWatch Logs 服務用量指標。 有效維度：Class, Resource, Service, Type 有效統計資訊：總和 單位：無
DeliveryErrors	將資料轉送至訂閱目的地時，CloudWatch Logs 接收到錯誤的日誌事件數量。如果目的地服務傳回可重試的錯誤，例如調節例外狀況或可重試的服務例外狀況 (例如 HTTP 5xx)，CloudWatch Logs 會繼續重試傳送，最多 24 小時。如果錯誤是不可重試的錯誤，例如 AccessDeniedException 或 ResourceNotFoundException，則 CloudWatch Logs 不會嘗試重新傳送。 有效維度：LogGroupName、DestinationType、FilterName、PolicyLevel 有效統計資訊：總和 單位：無
DeliveryThrottling	將資料轉送至訂閱目的地時，CloudWatch Logs 遭調節的日誌事件數量。 如果目的地服務傳回可重試的錯誤，例如調節例外狀況或可重試的服務例外狀況 (例如 HTTP 5xx)，CloudWatch Logs 會繼續重試傳送，最多 24 小時。如果錯誤是不可重試的錯誤，例如 AccessDeniedException 或 ResourceNotFoundException，則 CloudWatch Logs 不會嘗試重新傳送。 有效維度：LogGroupName、DestinationType、FilterName、PolicyLevel 有效統計資訊：總和 單位：無
EMFParsingErrors	處理內嵌指標格式日誌時遇到的剖析錯誤數量。如果日誌識別為內嵌指標格式，但未遵循正確格式，就會發生這類錯誤。如需有關內嵌指標格式的詳細資訊，請參閱規格：內嵌指標格式。 有效維度：LogGroupName 有效統計資訊：總和 單位：無
EMFValidationErrors	處理內嵌指標格式日誌時遇到的驗證錯誤數量。如果內嵌指標格式日誌中的指標定義不符合內嵌指標格式和 MetricDatum 規格，就會發生這類錯誤。如需有關 CloudWatch 內嵌指標格式的資訊，請參閱規格：內嵌指標格式。如需有關資料類型 MetricDatum 的資訊，請參閱《Amazon CloudWatch API 參考》中的 MetricDatum。 注意 某些驗證錯誤可能會導致 EMF 日誌中的多個指標無法發佈。例如，將捨棄具有無效命名空間的所有指標集。 有效維度：LogGroupName 有效統計資訊：總和 單位：無
ErrorCount	在您的帳戶中執行而導致錯誤的 API 操作數目。 ErrorCount 是 CloudWatch Logs 服務用量指標。如需詳細資訊，請參閱 CloudWatch Logs 服務用量指標。 有效維度：Class, Resource, Service, Type 有效統計資訊：總和 單位：無
ForwardedBytes	轉送至訂閱目的地的壓縮位元組中的日誌事件量。 有效維度：LogGroupName、DestinationType、FilterName 有效統計資訊：總和 單位：位元組
ForwardedLogEvents	轉送至訂閱目的地的日誌事件數量。 有效維度：LogGroupName、DestinationType、FilterName、PolicyLevel 有效統計資訊：總和 單位：無
IncomingBytes	上傳至 CloudWatch Logs 的未壓縮位元組中的日誌事件量。與 LogGroupName 維度搭配使用時，此為已上傳至日誌群組的未壓縮位元組中的日誌事件量。 有效維度：LogGroupName 有效統計資訊：總和 單位：位元組
IncomingLogEvents	上傳至 CloudWatch Logs 的日誌事件數量。與 LogGroupName 維度搭配使用時，此為已上傳至日誌群組的未壓縮位元組中的日誌事件數量。 有效維度：LogGroupName 有效統計資訊：總和 單位：無
LogEventsWithFindings	與使用 CloudWatch Logs 資料保護功能稽核的資料字串相符的日誌事件數。如需詳細資訊，請參閱使用遮罩功能協助保護敏感日誌資料。 有效維度：無 有效統計資訊：總和 單位：無
ThrottleCount	在您的帳戶中因用量配額而調節執行的 API 操作數目。 ThrottleCount 是 CloudWatch Logs 服務用量指標。如需詳細資訊，請參閱 CloudWatch Logs 服務用量指標。 有效維度：Class, Resource, Service, Type 有效統計資訊：總和 單位：無

CloudWatch Logs 指標的維度

您可以搭配大多數 CloudWatch Logs 指標使用的維度列於下表中。

維度	描述
LogGroupName	要顯示指標的 CloudWatch Logs 日誌群組的名稱。
DestinationType	CloudWatch Logs 資料的訂閱目的地，可以是 AWS Lambda、Amazon Kinesis Data Streams 或 Amazon Data Firehose。
FilterName	將資料從日誌群組轉送至目的地的訂閱篩選器名稱。訂閱篩選條件名稱由 CloudWatch 自動轉換為 ASCII，並以問號 (?) 取代任何不支援的字元。

訂閱篩選條件指標維度

與帳戶層級訂閱篩選條件相關的指標維度列於下表中。

維度	描述
PolicyLevel	政策適用的層級。目前，此維度的唯一有效值是 AccountPolicy
DestinationType	CloudWatch Logs 資料的訂閱目的地，可以是 AWS Lambda、Amazon Kinesis Data Streams 或 Amazon Data Firehose。
FilterName	將資料從日誌群組轉送至目的地的訂閱篩選器名稱。訂閱篩選條件名稱由 CloudWatch 自動轉換為 ASCII，並以問號 (?) 取代任何不支援的字元。

日誌轉換器指標和維度

CloudWatch Logs 會將下列日誌轉換器指標發佈至AWS/Logs命名空間中的 CloudWatch。

指標	描述
TransformationErrors	使用指定的轉換器轉換日誌事件時遇到的錯誤數目。 單位：無 有效統計資訊：總和
TransformedBytes	轉換日誌事件輸出的磁碟區，以未壓縮的位元組為單位。 單位：位元組 有效統計資訊：總和
TransformedLogEvents	轉換日誌事件的數量。 單位：無 有效統計資訊：總和

轉換器指標會使用下列維度。

維度	描述
LogGroupname	此維度僅用於log-group-level轉換器。
PolicyLevel	此維度僅用於帳戶層級轉換器。目前此維度的唯一有效值是 AccountPolicy

CloudWatch Logs 服務用量指標

CloudWatch Logs 會將指標傳送至 CloudWatch，以追蹤 CloudWatch Logs API 操作的使用情況。這些指標對應至 AWS 服務配額。追蹤這些指標可協助您主動管理配額。如需詳細資訊，請參閱 Service Quotas 整合與用量指標。

例如，您可以追蹤 ThrottleCount 指標，或在該指標設定警示。如果此指標的值上升，您應該考慮對遭調節的 API 操作要求增加配額。如需 CloudWatch Logs 服務配額的詳細資訊，請參閱 CloudWatch Logs 配額。

CloudWatch Logs 每分鐘會在 AWS/Usage 和 AWS/Logs 命名空間發佈服務配額用量指標。

下表列出 CloudWatch Logs 發佈的服務用量指標。這些指標沒有規定的單位。這些指標最實用的統計數字是 SUM，代表 1 分鐘期間的總操作計數。

每個指標會連同 Service、Class、Type 及Resource 全部維度的值一起發佈。也會連同稱為 Account Metrics 的單一維度一起發佈。使用 Account Metrics 維度查看帳戶中所有 API 操作的指標總和。使用其他維度，並指定 API 操作的名稱給 Resource 維度，以尋找該特定 API 的指標。

指標

指標	描述
CallCount	在您的帳戶中執行的指定操作數目。 CallCount 會發佈在 AWS/Usage 和 AWS/Logs 命名空間。
ErrorCount	在您的帳戶中執行而導致錯誤的 API 操作數目。 ErrorCount 只會發佈在 AWS/Logs。
ThrottleCount	在您的帳戶中因用量配額而調節執行的 API 操作數目。 ThrottleCount 只會發佈在 AWS/Logs。

Dimensions (尺寸)

維度	描述
Account metrics	使用此維度可取得所有 CloudWatch Logs API 中指標總和。 如果您想要查看某個特定 API 的指標，請使用此表格中列出的其他維度，並指定 API 名稱作為 Resource 的值。
Service	包含 資源 AWS 的服務名稱。對於 CloudWatch Logs 用量指標，此維度的值為 Logs。
Class	正在追蹤的資源類別。CloudWatch Logs API 用量指標使用此維度搭配值 None。
Type	正在追蹤的資源類型。目前，當 Service 維度為 Logs，Type 的唯一有效值為 API。
Resource	API 操作的名稱。有效值包括所有列在動作中的 API 操作名稱。例如 PutLogEvents