Registro em log de métricas para chamadas do plano de dados do AWS AppConfig
Se você configurou o AWS CloudTrail para registrar eventos de dados em log do AWS AppConfig, poderá permitir que o Amazon CloudWatch Logs registre métricas em log referentes a chamadas para o plano de dados do AWS AppConfig. Depois, é possível pesquisar e filtrar os dados de log no CloudWatch Logs criando um ou mais filtros de métrica. Os filtros de métrica definem os termos e os padrões a serem procurados nos dados de log à medida que são enviados ao CloudWatch Logs. O CloudWatch Logs usa filtros de métrica para transformar os dados de log em métricas numéricas do CloudWatch. É possível representar graficamente as métricas ou configurá-las com um alarme.
Antes de começar
Habilite o registro em log de eventos de dados do AWS AppConfig no AWS CloudTrail. O procedimento a seguir descreve como habilitar o registro em log de métricas para uma trilha do AWS AppConfig existente no CloudTrail. Para ter informações sobre como habilitar o registro em log do CloudTrail referentes a chamadas para o plano de dados do AWS AppConfig, consulte Eventos de dados do AWS AppConfig no CloudTrail.
Use o procedimento a seguir para permitir que o CloudWatch Logs registre métricas em log referentes a chamadas para o plano de dados do AWS AppConfig.
Como possibilitar que o CloudWatch Logs registre métricas de chamadas em log para o plano de dados do AWS AppConfig
Abra o console do CloudTrail em https://console.aws.amazon.com/cloudfront/
. -
No painel, escolha a trilha do AWS AppConfig.
-
Na seção CloudWatch Logs, selecione Editar.
-
Selecione Ativado.
-
Em Nome do grupo de logs, deixe o nome padrão ou insira um nome. Anote o nome. Você escolherá o grupo de logs no console do CloudWatch Logs posteriormente.
-
Em Nome do perfil, insira um nome.
-
Escolha Salvar alterações.
Use o procedimento a seguir para criar uma métrica e um filtro de métricas para o AWS AppConfig no 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).
Como criar uma métrica e um filtro de métricas para o AWS AppConfig no CloudWatch Logs
-
Abra o console do CloudWatch em https://console.aws.amazon.com/cloudwatch/
. -
No painel de navegação, escolha Logs e, em seguida, escolha Grupos de logs.
-
Marque a caixa de seleção ao lado do grupo de logs do AWS AppConfig.
-
Escolha Actions (Ações) e Create metric filter (Criar filtro de métrica).
-
Em Nome do filtro, insira um nome.
-
Em Padrão de filtro, insira o seguinte:
{ $.eventSource = "appconfig.amazonaws.com" } -
(Opcional) Na seção Testar padrão, selecione seu grupo de logs na lista Selecionar dados de log para testar. Se o CloudTrail não tiver registrado nenhuma chamada, você poderá ignorar esta etapa.
-
Escolha Próximo.
-
Em Namespace da métrica, digite
AWS AppConfig. -
Em Metric name (Nome da métrica), insira
Calls. -
Em Metric Value (Valor de métrica), insira
1. -
Ignore o Valor padrão e a Unidade.
-
Em Nome da dimensão, insira
operation. -
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.
-
Revise os detalhes do filtro e selecione Criar filtro de métrica.
(Opcional) É possível repetir esse procedimento para criar um filtro de métrica para um código de erro específico, como AccessDenied. Em caso afirmativo, insira os seguintes detalhes:
-
Em Nome do filtro, insira um nome.
-
Em Padrão de filtro, insira o seguinte:
{ $.errorCode = "codename" }Por exemplo
{ $.errorCode = "AccessDenied" } -
Em Namespace da métrica, digite
AWS AppConfig. -
Em Metric name (Nome da métrica), insira
Errors. -
Em Metric Value (Valor de métrica), insira
1. -
Em Valor padrão, insira um zero (0).
-
Ignore Unidade, Dimensões e Alarmes.
Depois que o CloudTrail registra as chamadas de API, é possível visualizar as métricas no CloudWatch. Para ter mais informações, consulte Visualizar métricas e logs no console no Guia do usuário do Amazon CloudWatch. Para ter informações sobre como localizar uma métrica que você criou, consulte Procurar por métricas disponíveis.
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.
Criar um alarme para a métrica do CloudWatch
Depois de criar métricas, é possível criar alarmes de métrica no CloudWatch. Por exemplo, é possível criar um alarme para a métrica de chamadas do AWS AppConfig que você criou no procedimento anterior. Especificamente, é possível criar um alarme para chamadas referentes à ação de API StartConfigurationSession do AWS AppConfig que ultrapassem um limite. Para ter mais informações sobre como criar um alarme para uma métrica, consulte Criar um alarme do CloudWatch com base em um limite estático no Guia do usuário do Amazon CloudWatch. Para ter informações sobre limites padrão referentes a chamadas para o plano de dados do AWS AppConfig, consulte Data plane default limits no Referência geral da Amazon Web Services.
