本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 CloudWatch 指標監控使用量
<a name="CloudWatch-Logs-Monitoring-CloudWatch-Metrics"></a>

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

## CloudWatch Logs 指標
<a name="cwl-metrics"></a>

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


| 指標 | Description | 
| --- | --- | 
| `CallCount` | 在您的帳戶中執行的特定 API 操作數目。<br />`CallCount` 是 CloudWatch Logs 服務用量指標。如需詳細資訊，請參閱 [CloudWatch Logs 服務用量指標](#CloudWatchLogs-Usage-Metrics)。<br />有效維度：Class, Resource, Service, Type<br />有效統計資訊：總和<br />單位：無 | 
| `DeliveryErrors` | 將資料轉送至訂閱目的地時，CloudWatch Logs 接收到錯誤的日誌事件數量。如果目的地服務傳回可重試的錯誤，例如調節例外狀況或可重試的服務例外狀況 (例如 HTTP 5xx)，CloudWatch Logs 會繼續重試傳送，最多 24 小時。如果錯誤是不可重試的錯誤，例如 `AccessDeniedException` 或 `ResourceNotFoundException`，則 CloudWatch Logs 不會嘗試重新傳送。<br />有效維度：LogGroupName、DestinationType、FilterName、PolicyLevel<br />有效統計資訊：總和<br />單位：無 | 
| `DeliveryThrottling` | 將資料轉送至訂閱目的地時，CloudWatch Logs 遭調節的日誌事件數量。<br />如果目的地服務傳回可重試的錯誤，例如調節例外狀況或可重試的服務例外狀況 (例如 HTTP 5xx)，CloudWatch Logs 會繼續重試傳送，最多 24 小時。如果錯誤是不可重試的錯誤，例如 `AccessDeniedException` 或 `ResourceNotFoundException`，則 CloudWatch Logs 不會嘗試重新傳送。<br />有效維度：LogGroupName、DestinationType、FilterName、PolicyLevel<br />有效統計資訊：總和<br />單位：無 | 
| `EMFDisabledErrors` | 由於符合日誌群組的 METRIC\_EXTRACTION\_POLICY 類型的作用中帳戶政策而忽略的 EMF 格式日誌事件數量。如需指標擷取政策的詳細資訊，請參閱 [PutAccountPolicy](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutAccountPolicy.html)。<br /> 有效維度：`LogGroupName`<br /> 有效統計資訊：總和 <br /> 單位：無  | 
| `EMFParsingErrors` |  處理內嵌指標格式日誌時遇到的剖析錯誤數量。如果日誌識別為內嵌指標格式，但未遵循正確格式，就會發生這類錯誤。如需有關內嵌指標格式的詳細資訊，請參閱[規格：內嵌指標格式](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Embedded_Metric_Format_Specification.html)。<br /> 有效維度：`LogGroupName`<br /> 有效統計資訊：總和 <br /> 單位：無  | 
| `EMFValidationErrors` |  處理內嵌指標格式日誌時遇到的驗證錯誤數量。如果內嵌指標格式日誌中的指標定義不符合內嵌指標格式和 `MetricDatum` 規格，就會發生這類錯誤。如需有關 CloudWatch 內嵌指標格式的資訊，請參閱[規格：內嵌指標格式](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Embedded_Metric_Format_Specification.html)。如需有關資料類型 `MetricDatum` 的資訊，請參閱《Amazon CloudWatch API 參考》中的 [MetricDatum](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_MetricDatum.html)。  某些驗證錯誤可能會導致 EMF 日誌中的多個指標無法發佈。例如，將捨棄具有無效命名空間的所有指標集。 <br /> 有效維度：`LogGroupName`<br /> 有效統計資訊：總和 <br /> 單位：無  | 
| `ErrorCount` | 在您的帳戶中執行而導致錯誤的 API 操作數目。<br />`ErrorCount` 是 CloudWatch Logs 服務用量指標。如需詳細資訊，請參閱 [CloudWatch Logs 服務用量指標](#CloudWatchLogs-Usage-Metrics)。<br />有效維度：Class, Resource, Service, Type<br />有效統計資訊：總和<br />單位：無 | 
| `ForwardedBytes` | 轉送至訂閱目的地的壓縮位元組中的日誌事件量。<br />有效維度：LogGroupName、DestinationType、FilterName <br />有效統計資訊：總和<br />單位：位元組 | 
| `ForwardedLogEvents` | 轉送至訂閱目的地的日誌事件數量。<br />有效維度：LogGroupName、DestinationType、FilterName、PolicyLevel<br />有效統計資訊：總和<br />單位：無 | 
| `IncomingBytes` | 上傳至 CloudWatch Logs 的未壓縮位元組中的日誌事件量。與 `LogGroupName` 維度搭配使用時，此為已上傳至日誌群組的未壓縮位元組中的日誌事件量。<br />有效維度：LogGroupName<br />有效統計資訊：總和<br />單位：位元組 | 
| `IncomingLogEvents` | 上傳至 CloudWatch Logs 的日誌事件數量。與 `LogGroupName` 維度搭配使用時，此為已上傳至日誌群組的未壓縮位元組中的日誌事件數量。<br />有效維度：LogGroupName<br />有效統計資訊：總和<br />單位：無 | 
| `LogEventsWithFindings` | 與使用 CloudWatch Logs 資料保護功能稽核的資料字串相符的日誌事件數。如需詳細資訊，請參閱[使用遮罩功能協助保護敏感日誌資料](mask-sensitive-log-data.md)。<br />有效維度：無<br />有效統計資訊：總和<br />單位：無 | 
| `ThrottleCount` | 在您的帳戶中因用量配額而調節執行的 API 操作數目。<br />`ThrottleCount` 是 CloudWatch Logs 服務用量指標。如需詳細資訊，請參閱 [CloudWatch Logs 服務用量指標](#CloudWatchLogs-Usage-Metrics)。<br />有效維度：Class, Resource, Service, Type<br />有效統計資訊：總和<br />單位：無 | 

## CloudWatch Logs 指標的維度
<a name="cwl-dimensions"></a>

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


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

**訂閱篩選條件指標維度**

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


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

## 日誌轉換器指標和維度
<a name="CloudWatchLogs-Transformer-Metrics"></a>

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


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

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


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

## 集中化指標和維度
<a name="CloudWatchLogs-Centralization-Metrics"></a>

若要跨多個帳戶和區域進行集中監控，您可以使用 CloudWatch Logs Centralization 在中央位置合併日誌資料和指標。如需詳細資訊，請參閱[跨帳戶跨區域日誌集中化](CloudWatchLogs_Centralization.md)。

CloudWatch Logs 會將下列集中化指標發佈至 `AWS/Logs` 命名空間中的 CloudWatch。這些指標可協助您在使用 CloudWatch Logs 集中化規則時，監控從來源帳戶到目的地帳戶的日誌資料複寫。

**注意**  
CloudWatch 會在您建立集中化規則後立即開始報告集中化指標。指標會盡最大努力發佈，並僅追蹤建立集中化規則後抵達的新日誌事件。


|  指標  |  Description  |  發佈於  | 
| --- | --- | --- | 
|  IncomingCopiedBytes  | 複寫至目的地帳戶的未壓縮位元組中的日誌資料量。此指標僅適用於建立集中化規則後抵達的新日誌事件。<br />有效維度：SourceRegion、SourceAccount<br />有效統計資訊：總和<br />單位：位元組 | 目的地帳戶 | 
|  IncomingCopiedLogEvents  | 複寫至目的地帳戶的日誌事件數目。此指標僅適用於建立集中化規則後抵達的新日誌事件。<br />有效維度：SourceRegion、SourceAccount<br />有效統計資訊：總和<br />單位：無 | 目的地帳戶 | 
|  OutgoingCopiedBytes  | 從來源帳戶傳送至目的地帳戶的未壓縮位元組日誌資料量。此指標僅適用於建立集中化規則後複製到目的地的新日誌事件。<br />有效維度：DestinationRegion<br />有效統計資訊：總和<br />單位：位元組 | 來源帳戶 | 
|  OutgoingCopiedLogEvents  | 從來源帳戶傳送至目的地帳戶的日誌事件數目。此指標僅適用於建立集中化規則後複製到目的地的新日誌事件。<br />有效維度：DestinationRegion<br />有效統計資訊：總和<br />單位：無 | 來源帳戶 | 
|  CentralizationError  | 複寫日誌資料時遇到的錯誤數目。由於 KMS 金鑰許可問題、日誌群組配額限制或日誌層不相符等各種原因，可能會發生錯誤。若要識別複寫失敗的特定日誌群組或日誌串流及其失敗原因，請監控 `ErrorType` 維度。<br />有效維度：ErrorType<br />有效統計資訊：總和<br />單位：無 | 目的地帳戶 | 
|  CentralizationThrottled  | 集中處理受到調節的次數。調節會導致集中處理速度變慢，但無法防止複寫日誌資料。<br />有效維度：DestinationRegion<br />有效統計資訊：總和<br />單位：無 | 來源帳戶 | 

集中化指標會使用下列維度。


|  維度  |  Description  | 
| --- | --- | 
|  SourceRegion  | 來源日誌資料的來源 AWS 區域。 | 
|  SourceAccount  | 來源日誌資料來源 AWS 的帳戶 ID。 | 
|  DestinationRegion  | 要複寫日誌資料 AWS 的區域。 | 
|  ErrorType  | 在集中化期間遇到的錯誤類型。可能的值包括：[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Monitoring-CloudWatch-Metrics.html) | 

## CloudWatch Logs 服務用量指標
<a name="CloudWatchLogs-Usage-Metrics"></a>

CloudWatch Logs 會將指標傳送至 CloudWatch，以追蹤 CloudWatch Logs API 操作的使用情況。這些指標對應至 AWS 服務配額。追蹤這些指標可協助您主動管理配額。如需詳細資訊，請參閱 [Service Quotas 整合與用量指標](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Service-Quota-Integration.html)。

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

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

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

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

**指標**


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

**Dimensions (尺寸)**


| 維度 | Description | 
| --- | --- | 
| `Account metrics` | 使用此維度可取得所有 CloudWatch Logs API 中指標總和。<br />如果您想要查看某個特定 API 的指標，請使用此表格中列出的其他維度，並指定 API 名稱作為 `Resource` 的值。 | 
| `Service` | 包含資源 AWS 的服務名稱。對於 CloudWatch Logs 用量指標，此維度的值為 `Logs`。 | 
| `Class` | 正在追蹤的資源類別。CloudWatch Logs API 用量指標使用此維度搭配值 `None`。 | 
| `Type` | 正在追蹤的資源類型。目前，當 `Service` 維度為 `Logs`，`Type` 的唯一有效值為 `API`。 | 
| `Resource` | API 操作的名稱。有效值包括所有列在[動作](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_Operations.html)中的 API 操作名稱。例如 `PutLogEvents` |