As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Métricas de registro para chamadas AWS AppConfig de planos de dados
<a name="monitoring-data-plane-call-logging"></a>

Se você configurou AWS CloudTrail para registrar eventos de AWS AppConfig dados, você pode permitir que o Amazon CloudWatch Logs registre métricas para chamadas para o plano de AWS AppConfig dados. Em seguida, você pode pesquisar e filtrar dados de registro no CloudWatch Logs criando um ou mais filtros de métrica. Os filtros de métricas definem os termos e padrões a serem procurados nos dados de registro à medida que são enviados para o CloudWatch Logs. CloudWatch O Logs usa filtros métricos para transformar dados de registro em CloudWatch métricas numéricas. É possível representar graficamente as métricas ou configurá-las com um alarme.

**Antes de começar**  
Ative o registro de eventos de AWS AppConfig dados em AWS CloudTrail. O procedimento a seguir descreve como ativar o registro de métricas para uma * AWS AppConfig trilha existente* CloudTrail. Para obter informações sobre como habilitar o CloudTrail registro para chamadas AWS AppConfig de planos de dados, consulte[AWS AppConfig eventos de dados em CloudTrail](logging-using-cloudtrail.md#cloudtrail-data-events).

Use o procedimento a seguir para permitir que o CloudWatch Logs registre métricas para chamadas para o plano AWS AppConfig de dados.

**Para permitir que o CloudWatch Logs registre métricas de chamadas para o plano AWS AppConfig de dados**

1. Abra o CloudTrail console em [https://console.aws.amazon.com/cloudtrail/](https://console.aws.amazon.com/cloudtrail/).

1. No painel, escolha sua AWS AppConfig trilha.

1. Na seção **CloudWatch Logs**, selecione **Editar**.

1. Selecione **Ativado**.

1. Em **Nome do grupo de logs**, deixe o nome padrão ou insira um nome. Anote o nome. Posteriormente, você escolherá o grupo de CloudWatch registros no console de registros.

1. Em **Nome do perfil**, insira um nome.

1. Escolha **Salvar alterações**.

Use o procedimento a seguir para criar uma métrica e um filtro de métrica para o AWS AppConfig CloudWatch Logs. O procedimento descreve como criar um filtro de métricas para chamadas por `operation` e (opcionalmente) chamadas por `operation` e `Amazon Resource Name (ARN)`.

**Para criar uma métrica e um filtro de métrica para o AWS AppConfig CloudWatch Logs**

1. Abra o CloudWatch console em[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. No painel de navegação, escolha **Logs** e, em seguida, escolha **Grupos de logs**.

1. Escolha a caixa de seleção ao lado do grupo de AWS AppConfig registros.

1. Escolha **Actions** (Ações) e **Create metric filter** (Criar filtro de métrica).

1. Em **Nome do filtro**, insira um nome.

1. Em **Padrão de filtro**, insira o seguinte:

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

1. (Opcional) Na seção **Testar padrão**, selecione seu grupo de logs na lista **Selecionar dados de log para testar**. Se CloudTrail não tiver registrado nenhuma chamada, você pode pular esta etapa.

1. Escolha **Próximo**.

1. Em **Namespace da métrica**, digite **AWS AppConfig**.

1. Em **Metric name** (Nome da métrica), insira **Calls**.

1. Em **Valor de métrica**, insira **1**.

1. Ignore o **Valor padrão** e a **Unidade**.

1. Em **Nome da dimensão**, insira **operation**.

1. Em **Valor da dimensão**, insira **$.eventName**.

   (Opcional) É possível inserir uma segunda dimensão que inclua o nome do recurso da Amazon (ARN) que está fazendo a chamada. Para adicionar uma segunda dimensão, em **Nome da dimensão**, insira **resource**. Em **Valor da dimensão**, insira **$.resources[0].ARN**.

   Escolha **Próximo**.

1. Revise os detalhes do filtro e selecione **Criar filtro de métrica**.

(Opcional) Você pode repetir esse procedimento para criar um novo filtro métrico para um código de erro específico, como *AccessDenied*. Em caso afirmativo, insira os seguintes detalhes:

1. Em **Nome do filtro**, insira um nome.

1. Em **Padrão de filtro**, insira o seguinte:

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

   Por exemplo

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

1. Em **Namespace da métrica**, digite **AWS AppConfig**.

1. Em **Metric name** (Nome da métrica), insira **Errors**.

1. Em **Valor de métrica**, insira **1**.

1. Em **Valor padrão**, insira um zero (0).

1. Ignore **Unidade**, **Dimensões** e **Alarmes**.

Depois de CloudTrail registrar as chamadas de API, você pode ver as métricas em CloudWatch. Para obter mais informações, consulte [Visualizar suas métricas e registros no console](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Embedded_Metric_Format_View.html) no *Guia do CloudWatch usuário da Amazon*. Para ter informações sobre como localizar uma métrica que você criou, consulte [Procurar por métricas disponíveis](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/finding_metrics_with_cloudwatch.html).

**nota**  
Se você configurar a métrica de erro sem dimensão, conforme descrito aqui, poderá visualizar essas métricas na página **Métricas sem dimensões**.

## Criando um alarme para uma CloudWatch métrica
<a name="monitoring-data-plane-call-logging-alarms"></a>

Depois de criar métricas, você pode criar alarmes métricos em CloudWatch. Por exemplo, é possível criar um alarme para a métrica de *chamadas do AWS AppConfig * que você criou no procedimento anterior. Especificamente, você pode criar um alarme para chamadas para a ação da AWS AppConfig `StartConfigurationSession` API que ultrapassam um limite. Para obter informações sobre como criar um alarme para uma métrica, consulte [Criar um CloudWatch alarme com base em um limite estático](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html) no *Guia do CloudWatch usuário da Amazon*. Para obter informações sobre limites padrão para chamadas para o plano de AWS AppConfig dados, consulte [Limites padrão do plano de dados](https://docs.aws.amazon.com/general/latest/gr/appconfig.html#limits_appconfig) no *Referência geral da Amazon Web Services*.