Exemplo: contar as ocorrências de um termo - CloudWatch Registros da Amazon

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á.

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 logs MyApp/message.log. O CloudWatch Logs publica um ponto de dados na métrica personalizada ErrorCount do CloudWatch no namespace MyApp/message.log com um valor de “1” para cada evento que contenha 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 exibir a métrica no console do CloudWatch. 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 de métrica usando o console do CloudWatch
  1. Abra o console do CloudWatch 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 Detalhes da métrica, para Namespace da métrica, digite MyNameSpace.

  9. Em 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 de métrica usando a 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 a 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"