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
<a name="CountOccurrencesExample"></a>

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 representar graficamente esses dados no CloudWatch console, certifique-se de usar a estatística da 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html).

**Para criar um filtro métrico usando o CloudWatch console**

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 **Grupos de logs**.

1. Escolha o nome do grupo de logs.

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

1. Em **Padrão de filtro**, insira **Error**.
**nota**  
Todas as entradas em **Filtrar padrão** fazem distinção de maiúsculas e minúsculas.

1. (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).

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

1. Em **Detalhes da métrica**, em **Namespace da métrica**, digite **MyNameSpace**.

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

1. 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".

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

1. 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"
```