Exemplo: contar as ocorrências de um termo

Os eventos de log frequentemente incluem mensagens importantes que você deseja contar, talvez sobre o êxito ou a falha de operações. Por exemplo, poderá ocorrer um erro e ele ser registrado em um arquivo de log se ocorrer uma falha em uma determinada operação. É possível monitorar essas entradas para entender a tendência dos erros.

No exemplo abaixo, um filtro de métrica é criado para monitorar o termo Erro. A política foi criada e adicionada ao grupo de registros MyApp/message.log. CloudWatch O Logs publica um ponto de dados ErrorCount na métrica CloudWatch personalizada no namespace MyApp/message.log com o valor “1" para cada evento que contém Error. Se não houver um evento com a palavra Erro, será publicado um valor de 0. Ao criar gráficos com esses dados no console do CloudWatch, certifique-se de usar a estatística de soma.

Depois de criar um filtro de métrica, você pode ver a métrica no CloudWatch console. Ao selecionar a métrica a ser exibida, selecione o namespace da métrica que corresponde ao nome do grupo de logs. Para obter mais informações, consulte Visualizar métricas disponíveis.

Para criar um filtro métrico usando o CloudWatch console

1. Abra o CloudWatch console em https://console.aws.amazon.com/cloudwatch/.

2. No painel de navegação, escolha Grupos de logs.

3. Escolha o nome do grupo de logs.

4. Escolha Ações, Criar filtro de métrica.

5. Em Padrão de filtro, insira Error.

   nota

   Todas as entradas em Filtrar padrão fazem distinção de maiúsculas e minúsculas.

6. (Opcional) Para testar seu padrão de filtro, em Test Pattern (Testar padrão), insira um ou mais eventos de log a serem usados para testar o padrão. Cada evento de log deve estar dentro de uma linha, porque as quebras de linha são usadas para separar eventos de log na caixa Log event messages (Mensagens do evento de log).

7. Escolha Próximo e, na página Atribuir métrica, em Nome do filtro, digite MyAppErrorCount.

8. Em Metric Details (Detalhes da métrica), em Metric Namespace (Namespace da métrica), digite MyNameSpace.

9. Para Metric Name (Nome da métrica), digite ErrorCount.

10. Confirme se o Valor da métrica é 1. Isso especifica que a contagem é aumentada em 1 para cada evento de log que contém "Erro".

11. Para Valor padrão, digite 0 e escolha Próximo.

12. Escolha Criar filtro de métrica.

Para criar um filtro métrico usando o AWS CLI

Em um prompt de comando, execute o seguinte comando:

aws logs put-metric-filter \
  --log-group-name MyApp/message.log \
  --filter-name MyAppErrorCount \
  --filter-pattern 'Error' \
  --metric-transformations \
      metricName=ErrorCount,metricNamespace=MyNamespace,metricValue=1,defaultValue=0

Você pode testar essa nova política postando eventos que contenham a palavra "Erro" na mensagem.

Para publicar eventos usando o AWS CLI

Em um prompt de comando, execute o seguinte comando da . Os padrões fazem distinções de maiúsculas e minúsculas.

aws logs put-log-events \
  --log-group-name MyApp/access.log --log-stream-name TestStream1 \
  --log-events \
    timestamp=1394793518000,message="This message contains an Error" \
    timestamp=1394793528000,message="This message also contains an Error"