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

# 记录 Amazon AppConfig 数据平面调用的指标
<a name="monitoring-data-plane-call-logging"></a>

如果您配置 Amazon CloudTrail 为记录 Amazon AppConfig 数据事件，则可以启用 Amazon Logs 来 CloudWatch 记录 Amazon AppConfig 数据平面调用的指标。然后，您可以通过创建一个或多个指标筛选器来搜索和筛选 CloudWatch 日志中的日志数据。指标筛选器定义了发送到日志时要 CloudWatch 在日志数据中查找的术语和模式。 CloudWatch 日志使用指标筛选器将日志数据转换为数字 CloudWatch 指标。可以绘制指标图表或为指标配置警报。

**开始前的准备工作**  
在中启用 Amazon AppConfig 数据事件的记录 Amazon CloudTrail。以下过程介绍如何为中的*现有 Amazon AppConfig 跟踪*启用指标记录 CloudTrail。有关如何为 Amazon AppConfig 数据计划调用启用 CloudTrail 日志记录的信息，请参阅[Amazon AppConfig 中的数据事件 CloudTrail](logging-using-cloudtrail.md#cloudtrail-data-events)。

使用以下过程启用 Log CloudWatch s 来记录 Amazon AppConfig 数据平面调用的指标。

**启用 Logs 来 CloudWatch 记录 Amazon AppConfig 数据平面调用的指标**

1. 打开 CloudTrail 控制台，网址为[https://console.aws.amazon.com/cloudtrail/](https://console.amazonaws.cn/cloudtrail/)。

1. 在仪表板上，选择您的 Amazon AppConfig 路线。

1. 在**CloudWatch 标签**部分中，选择**编辑**。

1. 选择 **Enabled (已启用)**。

1. 对于**日志组名称**，请保留默认名称或输入一个名称。记录下名称。稍后您将在 “日志” 控制台中选择 CloudWatch 日志组。

1. 对于**角色名称**，输入一个名称。

1. 选择**保存更改**。

使用以下过程在 Lo CloudWatch gs Amazon AppConfig 中为其创建指标和指标筛选器。该过程介绍如何按 `operation` 为调用以及（可选）按 `operation` 和 `Amazon Resource Name (ARN)` 为调用创建指标筛选条件。

**在 Lo CloudWatch gs Amazon AppConfig 中为创建指标和指标筛选器**

1. 打开 CloudWatch 控制台，网址为[https://console.amazonaws.cn/cloudwatch/](https://console.amazonaws.cn/cloudwatch/)。

1. 在导航窗格中，选择 **Logs**（日志），然后选择 **Log groups（日志组）**。

1. 选中 Amazon AppConfig 日志组旁边的复选框。

1. 选择 **Actions**（操作），然后选择 **Create metric filter**（创建指标筛选条件）。

1. 对于**筛选条件名称**，输入名称。

1. 对于**筛选模式**，输入以下内容：

   ```
   { $.eventSource = "appconfig.amazonaws.com" }
   ```

1. （可选）在**测试模式**部分中，从**选择要测试的日志数据**列表中选择日志组。如果 CloudTrail 尚未记录任何通话，则可以跳过此步骤。

1. 选择**下一步**。

1. 对于**指标命名空间**，输入 **Amazon AppConfig**。

1. 对于 **Metric name**（指标名称），请输入 **Calls**。

1. 对于 **Metric value（指标值）**，输入 **1**。

1. 跳过**默认值**和**单位**。

1. 对于**维度名称**，输入 **operation**。

1. 对于**维度值**，输入 **\$1.eventName**。

   （可选）可以输入第二个维度，该维度包含发起调用的 Amazon 资源名称（ARN）。要添加第二个维度，对于**维度名称**，输入 **resource**。对于**维度值**，输入 **\$1.resources[0].ARN**。

   选择**下一步**。

1. 查看筛选条件的详细信息并**创建指标筛选条件**。

（可选）您可以重复此过程，为特定的错误代码（例如）创建新的指标筛选器*AccessDenied*。如果您这样做，请输入以下详细信息：

1. 对于**筛选条件名称**，输入名称。

1. 对于**筛选模式**，输入以下内容：

   ```
   { $.errorCode = "codename" }
   ```

   例如

   ```
   { $.errorCode = "AccessDenied" }
   ```

1. 对于**指标命名空间**，输入 **Amazon AppConfig**。

1. 对于 **Metric name**（指标名称），请输入 **Errors**。

1. 对于 **Metric value（指标值）**，输入 **1**。

1. 对于**默认值**，输入零（0）。

1. 跳过**单位**、**维度**和**警报**。

 CloudTrail 记录 API 调用后，您可以在中查看指标 CloudWatch。有关更多信息，请参阅 *Amazon CloudWatch 用户指南*[中的在控制台中查看您的指标和日志](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/CloudWatch_Embedded_Metric_Format_View.html)。有关如何找到您创建的指标的信息，请参阅[搜索可用指标](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/finding_metrics_with_cloudwatch.html)。

**注意**  
如果您按照此处所述设置了没有维度的错误指标，则可以在**无维度指标**页面上查看这些指标。

## 为 CloudWatch 指标创建警报
<a name="monitoring-data-plane-call-logging-alarms"></a>

创建指标后，可以在中创建指标警报 CloudWatch。例如，可以为在之前过程中创建的 *Amazon AppConfig 调用* 指标创建警报。具体而言，您可以为超出阈值 Amazon AppConfig `StartConfigurationSession`的 API 操作调用创建警报。有关如何为指标创建警报的信息，请参阅 *Amazon CloudWatch 用户指南*中的[基于静态阈值创建 CloudWatch 警报](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html)。有关 Amazon AppConfig 数据平面调用的默认限制的信息，请参阅中的[数据平面默认限制*Amazon Web Services 一般参考*](https://docs.amazonaws.cn/general/latest/gr/appconfig.html#limits_appconfig)。