本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用 CloudWatch 指标进行监控
<a name="CloudWatch-Logs-Monitoring-CloudWatch-Metrics"></a>

 您可以使用本节中的表格来查看 Amazon CloudWatch Logs CloudWatch 每分钟发送给亚马逊的指标。

## CloudWatch 记录指标
<a name="cwl-metrics"></a>

`AWS/Logs` 命名空间包括以下指标。


| 指标 | 说明 | 
| --- | --- | 
| `CallCount` | 在您账户中执行的指定 API 操作的数量。<br />`CallCount`是一项 CloudWatch 日志服务使用量指标。有关更多信息，请参阅 [CloudWatch 记录服务使用情况指标](#CloudWatchLogs-Usage-Metrics)。<br />有效维度：类、资源、服务、类型<br />有效统计数据：Sum<br />单位：无 | 
| `DeliveryErrors` | 在将数据转发到订阅目标时，Lo CloudWatch gs 收到错误的日志事件的数量。如果目标服务返回可重试的错误，例如限制异常或可重试的服务异常（例如 HTTP 5xx），则 CloudWatch 日志会继续重试传送长达 24 小时。 CloudWatch 如果错误是不可重试的错误（例如或），则日志不会尝试重新传送。`AccessDeniedException` `ResourceNotFoundException`<br />有效尺寸： LogGroupName、 DestinationType、 FilterName、 PolicyLevel<br />有效统计数据：Sum<br />单位：无 | 
| `DeliveryThrottling` | 将数据转发到订阅目标时，限制 CloudWatch 日志的日志事件数量。<br />如果目标服务返回可重试的错误，例如限制异常或可重试的服务异常（例如 HTTP 5xx），则 CloudWatch 日志会继续重试传送长达 24 小时。 CloudWatch 如果错误是不可重试的错误（例如或），则日志不会尝试重新传送。`AccessDeniedException` `ResourceNotFoundException`<br />有效尺寸： LogGroupName、 DestinationType、 FilterName、 PolicyLevel<br />有效统计数据：Sum<br />单位：无 | 
| `EMFDisabledErrors` | 由于与日志组匹配的 METRIC\_EXTRACTION\_POLICY 类型的活动账户策略而被忽略的 EMF 格式的日志事件的数量。有关指标提取策略的更多信息，请参阅。[PutAccountPolicy](https://docs.amazonaws.cn/AmazonCloudWatchLogs/latest/APIReference/API_PutAccountPolicy.html)<br /> 有效维度：`LogGroupName`<br /> 有效统计数据：Sum <br /> 单位：无  | 
| `EMFParsingErrors` |  处理嵌入式指标格式日志时遇到的解析错误数量。当日志被识别为嵌入式指标格式但不遵循正确的格式时，就会发生此类错误。有关嵌入式指标格式的更多信息，请参阅[规范：嵌入式指标格式](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/CloudWatch_Embedded_Metric_Format_Specification.html)。<br /> 有效维度：`LogGroupName`<br /> 有效统计数据：Sum <br /> 单位：无  | 
| `EMFValidationErrors` |  处理嵌入式指标格式日志时遇到的验证错误数量。当嵌入式指标格式日志中的指标定义不遵循嵌入式指标格式和 `MetricDatum` 规范时，就会出现这些错误。有关 CloudWatch 嵌入式指标格式的信息，请参阅[规范：嵌入式指标格式](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/CloudWatch_Embedded_Metric_Format_Specification.html)。有关数据类型的信息`MetricDatum`，请参阅 *Amazon CloudWatch API 参考[MetricDatum](https://docs.amazonaws.cn/AmazonCloudWatch/latest/APIReference/API_MetricDatum.html)*中的。  某些验证错误可能导致 EMF 日志中的多个指标未发布。例如，所有使用无效命名空间设置的指标均将被删除。 <br /> 有效维度：`LogGroupName`<br /> 有效统计数据：Sum <br /> 单位：无  | 
| `ErrorCount` | 在您账户中执行的导致了错误的 API 操作的数量。<br />`ErrorCount`是一项 CloudWatch 日志服务使用量指标。有关更多信息，请参阅 [CloudWatch 记录服务使用情况指标](#CloudWatchLogs-Usage-Metrics)。<br />有效维度：类、资源、服务、类型<br />有效统计数据：Sum<br />单位：无 | 
| `ForwardedBytes` | 以压缩字节转发到订阅目标的日志事件的容量。<br />有效尺寸： LogGroupName、 DestinationType、 FilterName <br />有效统计数据：Sum<br />单位：字节 | 
| `ForwardedLogEvents` | 转发到订阅目标的日志事件的数量。<br />有效尺寸： LogGroupName、 DestinationType、 FilterName、 PolicyLevel<br />有效统计数据：Sum<br />单位：无 | 
| `IncomingBytes` | 上传到日志的日志事件量（以未压缩字节为 CloudWatch 单位）。当用于 `LogGroupName` 维度时，这是以未压缩字节上传到日志组的日志事件的容量。<br />有效尺寸： LogGroupName<br />有效统计数据：Sum<br />单位：字节 | 
| `IncomingLogEvents` | 上传到 CloudWatch 日志的日志事件数量。当用于 `LogGroupName` 维度时，这是上传到日志组的日志事件的数量。<br />有效尺寸： LogGroupName<br />有效统计数据：Sum<br />单位：无 | 
| `LogEventsWithFindings` | 与您正在使用日志数据保护功能审核的数据字符串相匹配的 CloudWatch 日志事件数量。有关更多信息，请参阅 [通过屏蔽帮助保护敏感的日志数据](mask-sensitive-log-data.md)。<br />有效维度：无<br />有效统计数据：Sum<br />单位：无 | 
| `ThrottleCount` | 因使用量配额而被限制在您账户中执行的 API 操作数量。<br />`ThrottleCount`是一项 CloudWatch 日志服务使用量指标。有关更多信息，请参阅 [CloudWatch 记录服务使用情况指标](#CloudWatchLogs-Usage-Metrics)。<br />有效维度：类、资源、服务、类型<br />有效统计数据：Sum<br />单位：无 | 

## CloudWatch 日志指标的维度
<a name="cwl-dimensions"></a>

下表列出了可用于大多数 CloudWatch Logs 指标的维度。


|  维度  |  说明  | 
| --- | --- | 
|  LogGroupName  | 要显示其指标的 CloudWatch 日志日志组的名称。 | 
|  DestinationType  |  CloudWatch 日志数据的订阅目标，可以是 Amazon Lambda Amazon Kinesis Data Streams 或 Amazon Data Firehose。 | 
|  FilterName  | 将数据从日志组转发到目标的订阅筛选器的名称。订阅筛选器名称会自动转换 CloudWatch 为 ASCII，任何不支持的字符都将替换为问号 (?)。 | 

**订阅筛选指标维度**

下表列出了与账户级订阅筛选条件相关的指标维度。


|  维度  |  说明  | 
| --- | --- | 
|  PolicyLevel  | 策略适用的级别。目前，此维度的唯一有效值是 `AccountPolicy` | 
|  DestinationType  |  CloudWatch 日志数据的订阅目标，可以是 Amazon Lambda Amazon Kinesis Data Streams 或 Amazon Data Firehose。 | 
|  FilterName  | 将数据从日志组转发到目标的订阅筛选器的名称。订阅筛选器名称会自动转换 CloudWatch 为 ASCII，任何不支持的字符都将替换为问号 (?)。 | 

## 日志转换器指标和维度
<a name="CloudWatchLogs-Transformer-Metrics"></a>

CloudWatch Logs 将以下日志转换器指标发布到`AWS/Logs`命名空间 CloudWatch 中。


|  指标  |  说明  | 
| --- | --- | 
|  TransformationErrors  | 使用指定转换器转换日志事件时遇到的错误数量。<br />单位：无<br />有效统计数据：总计 | 
|  TransformedBytes  | 转换后的日志事件的输出量，以未压缩字节为单位。<br />单位：字节<br />有效统计数据：总计 | 
|  TransformedLogEvents  | 转换后的日志事件数量。<br />单位：无<br />有效统计数据：总计 | 

转换器指标会使用以下维度。


|  维度  |  说明  | 
| --- | --- | 
|  LogGroupname  | 此尺寸仅用于 log-group-level变压器。 | 
|  PolicyLevel  | 此维度仅用于账户级转换器。目前，此维度的唯一有效值是 `AccountPolicy` | 

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

要对多个账户和区域进行集中监控，您可以使用 CloudWatch 日志集中将日志数据和指标整合到一个中心位置。有关更多信息，请参阅 [跨账户跨区域日志集中化](CloudWatchLogs_Centralization.md)。

CloudWatch Logs 将以下集中化指标发布到`AWS/Logs`命名空间 CloudWatch 中。这些指标可帮助您在使用日志集中化规则时监控从源账户到目标账户的 CloudWatch 日志数据复制情况。

**注意**  
CloudWatch 在您创建集中化规则后不久就开始报告集中化指标。指标是尽力发布的，并且仅跟踪在创建集中规则后到达的新日志事件。


|  指标  |  说明  |  发布位置  | 
| --- | --- | --- | 
|  IncomingCopiedBytes  | 复制到目标账户的日志数据量（以未压缩字节为单位）。此指标仅适用于创建集中化规则后到达的新日志事件。<br />有效尺寸： SourceRegion， SourceAccount<br />有效统计数据：Sum<br />单位：字节 | 目标账户 | 
|  IncomingCopiedLogEvents  | 复制到目标账户的日志事件数量。此指标仅适用于创建集中化规则后到达的新日志事件。<br />有效尺寸： SourceRegion， SourceAccount<br />有效统计数据：Sum<br />单位：无 | 目标账户 | 
|  OutgoingCopiedBytes  | 从源账户发送到目标账户的日志数据量（以未压缩字节为单位）。此指标仅适用于在创建集中规则后复制到目标的新日志事件。<br />有效尺寸： DestinationRegion<br />有效统计数据：Sum<br />单位：字节 | 源账户 | 
|  OutgoingCopiedLogEvents  | 从源账户发送到目标账户的日志事件数量。此指标仅适用于在创建集中规则后复制到目标的新日志事件。<br />有效尺寸： DestinationRegion<br />有效统计数据：Sum<br />单位：无 | 源账户 | 
|  CentralizationError  | 复制日志数据时遇到的错误数。错误可能由多种原因导致，例如 KMS 密钥权限问题、日志组配额限制或日志层不匹配。要识别复制失败的特定日志组或日志流及其失败原因，请监控`ErrorType`维度。<br />有效尺寸： ErrorType<br />有效统计数据：Sum<br />单位：无 | 目标账户 | 
|  CentralizationThrottled  | 集中化处理被限制的次数。限制会导致集中化处理速度变慢，但不会阻止日志数据的复制。<br />有效尺寸： DestinationRegion<br />有效统计数据：Sum<br />单位：无 | 源账户 | 

集中化指标使用以下维度。


|  维度  |  说明  | 
| --- | --- | 
|  SourceRegion  | 源日志数据来源的 Amazon 区域。 | 
|  SourceAccount  | 源日志数据来源的 Amazon 账户 ID。 | 
|  DestinationRegion  | 要将日志数据复制到的 Amazon 区域。 | 
|  ErrorType  | 集中化期间遇到的错误类型。可能的值包括：[See the AWS documentation website for more details](http://docs.amazonaws.cn/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Monitoring-CloudWatch-Metrics.html) | 

## CloudWatch 记录服务使用情况指标
<a name="CloudWatchLogs-Usage-Metrics"></a>

CloudWatch 日志向其发送指标 CloudWatch ，用于跟踪日 CloudWatch 志 API 操作的使用情况。这些指标对应于 Amazon 服务配额。跟踪这些指标可帮助您主动管理限额。有关更多信息，请参阅 [Service Quotas 集成和使用量指标](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/CloudWatch-Service-Quota-Integration.html)。

例如，您可以跟踪 `ThrottleCount` 指标或为该指标设置警报。如果该指标的值上升，则应考虑为受到限制的 API 操作请求增加配额。有关 CloudWatch 日志服务配额的更多信息，请参阅[CloudWatch 日志配额](cloudwatch_limits_cwl.md)。

CloudWatch 日志每分钟都会在`AWS/Usage`和`AWS/Logs`命名空间中发布服务配额使用量指标。

下表列出了 Logs 发布的服务使用情况 CloudWatch 指标。这些指标没有指定的单位。指标中最实用的统计数据是 `SUM`，它表示以 1 分钟为间隔的总操作数。

这些指标中的每个指标都会发布，其中包含所有 `Service`、`Class`、`Type` 和 `Resource` 维度的值。它们还与一个名为 `Account Metrics` 的单一维度一同发布。使用 `Account Metrics` 维度来查看您账户中所有 API 操作的指标总和。使用其他维度并指定 `Resource` 维度的 API 操作名称，以查找该特定 API 的指标。

**Metrics**


| 指标 | 说明 | 
| --- | --- | 
| `CallCount` | 在您的账户中执行的指定操作的数量。<br />`CallCount` 同时发布在 `AWS/Usage` 和 `AWS/Logs` 命名空间中。 | 
| `ErrorCount` | 在您账户中执行的导致了错误的 API 操作的数量。<br />`ErrorCount` 仅发布在 `AWS/Logs` 中。 | 
| `ThrottleCount` | 因使用量配额而被限制在您账户中执行的 API 操作数量。<br />`ThrottleCount` 仅发布在 `AWS/Logs` 中。 | 

**Dimensions**


| 维度 | 说明 | 
| --- | --- | 
| `Account metrics` | 使用此维度获取所有 CloudWatch 日志中指标的总和 APIs。<br />如果要查看一个特定 API 的指标，请使用此表中列出的其他维度，并将该 API 名称指定为 `Resource` 的值。 | 
| `Service` | 包含资源的 Amazon 服务的名称。对于 CloudWatch 日志使用量指标，此维度的值为`Logs`。 | 
| `Class` | 正在跟踪的资源类别。 CloudWatch 日志 API 使用情况指标使用此维度，其值为`None`。 | 
| `Type` | 所跟踪的资源的类型。目前，当 `Service` 维度为 `Logs` 时，`Type` 的唯一有效值为 `API`。 | 
| `Resource` | API 操作的名称。有效值包括[操作](https://docs.amazonaws.cn/AmazonCloudWatchLogs/latest/APIReference/API_Operations.html)中列出的所有 API 操作名称。例如，`PutLogEvents` |