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

# Criar um filtro de métrica para um grupo de logs
<a name="CreateMetricFilterProcedure"></a>

Para criar um filtro de métrica para um grupo de logs, siga estas etapas. A métrica não será visível até que haja alguns pontos de dados para ela.

**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 **Logs** e, em seguida, escolha **Grupos de logs**. 

1.  Escolha o nome do grupo de logs. 

1.  Escolha `Actions` e **Create metric filter** (Criar filtro de métrica). 

1.  Em **Padrão de filtro**, insira o padrão de filtro. Para obter mais informações, consulte [Sintaxe de padrões de filtros para filtros de métricas, filtros de assinatura, filtros de eventos de log e Live Tail.](FilterAndPatternSyntax.md). 

1.  (Opcional) Se estiver usando grupos de logs centralizados, em **Critérios de seleção de filtros**, você poderá especificar filtros com base na conta de origem (`@aws.account`), na região de origem (`@aws.region`) ou em ambas as condições.

1.  (Opcional) Para testar seu padrão de filtro, em **Test Pattern** (Testar padrão), insira um ou mais eventos de logs para testar o padrão. Cada evento de logs deve ser formatado em uma linha. Quebras de linha são usadas para separar eventos de logs na caixa **Log event messages** (Mensagens de log de eventos). 

1.  Escolha **Next** (Próximo) e digite um nome para o filtro de métrica. 

1.  Em **Detalhes da métrica**, em **Namespace métrica**, insira um nome para o CloudWatch namespace em que a métrica será publicada. Se esse namespace ainda não existir, certifique-se de que a opção **Create new** (Criar novo) esteja selecionada. 

1.  Em **Metric name** (Nome da métrica), insira um nome para a nova métrica. 

1.  Em **Metric value** (Valor da métrica), se o filtro de métrica estiver contando ocorrências das palavras-chave no filtro, digite 1. Isso incrementa a métrica em 1 para cada evento de log que contém uma das palavras-chave. 

    Se preferir, insira um token, como **\$1size**. Isso incrementa a métrica pelo valor do número no campo `size` para cada evento de log que contém um campo `size`. 

1.  (Opcional) Em **Unit** (Unidade), selecione uma unidade para atribuir à métrica. Se você não especificar uma unidade, a unidade será definida como `None`. 

1.  (Opcional) Insira os nomes e tokens de até três dimensões para a métrica. Se você atribuir dimensões a métricas criadas por filtros de métrica, não poderá atribuir valores padrões para essas métricas. 
**nota**  
 As dimensões são compatíveis apenas com filtros de métrica JSON ou delimitados por espaço. 

1.  Escolha **Criar filtro de métrica**. Você pode encontrar o filtro de métrica que criou no painel de navegação. Escolha **Logs** e depois escolha **Log groups** (Grupo de logs). Escolha o nome do grupo de logs para o qual você criou o filtro de métrica e, em seguida, selecione a guia **Metric filters** (Filtros de métrica).