# Incorporação de métricas em logs
<a name="CloudWatch_Embedded_Metric_Format"></a>

O formato de métricas incorporadas do CloudWatch permite gerar métricas personalizadas de forma assíncrona na forma de logs gravados no CloudWatch Logs. É possível incorporar métricas personalizadas com dados detalhados de eventos de log, e o CloudWatch automaticamente extrairá as métricas personalizadas para que você possa visualizar e criar alarmes para elas visando a detecção de incidentes em tempo real. Além disso, os eventos de log detalhados associados às métricas extraídas podem ser consultados usando o CloudWatch Logs Insights para fornecer insights precisos sobre as causas raízes de eventos operacionais. 

O formato de métricas incorporadas ajuda a gerar métricas personalizadas acionáveis de recursos efêmeros, como funções e contêineres do Lambda. Agora, ao usar o formato de métricas incorporadas para enviar logs desses recursos efêmeros, é possível criar métricas personalizadas facilmente, sem precisar instrumentar ou manter código separado, ao mesmo tempo que obtém recursos analíticos poderosos nos dados de log.

Nenhuma configuração é necessária para usar o formato de métricas incorporadas. Estruture seus logs seguindo a [Especificação do formato de métricas incorporadas](CloudWatch_Embedded_Metric_Format_Specification.md) ou gere-os usando nossas bibliotecas de cliente e envie-os para o CloudWatch Logs usando a [API PutLogEvents](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html) ou o [agente do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Embedded_Metric_Format_Generation_CloudWatch_Agent.html). 

Para gerar métricas a partir de logs com um formato de métrica incorporado, você precisa da permissão `logs:PutLogEvents`, mas não precisa ter também a permissão `cloudwatch:PutMetricData`.

Há cobranças para a ingestão e o arquivamento de logs e para as métricas personalizadas que são geradas. Para obter mais informações, consulte [Preços do Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing).

**nota**  
Tenha cuidado ao configurar a extração de métricas, já que isso impacta o uso da métrica personalizada e o faturamento correspondente. Se você criar acidentalmente métricas baseadas em dimensões de alta cardinalidade (como `requestId`), o formato de métricas incorporadas criará por design uma métrica personalizada correspondente a cada combinação de dimensão exclusiva. Para obter mais informações, consulte [Dimensões](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension).

 Os tópicos apresentados a seguir descrevem como publicar logs usando o formato de métricas incorporadas, visualizar as métricas e os logs no console, e definir alarmes para as métricas criadas com o formato de métricas incorporadas. 

**Topics**
+ [Publicação de logs com o formato de métricas incorporadas](CloudWatch_Embedded_Metric_Format_Generation.md)
+ [Visualizar métricas e logs no console](CloudWatch_Embedded_Metric_Format_View.md)
+ [Configuração de alarmes em métricas criadas com o formato de métricas incorporadas](CloudWatch_Embedded_Metric_Format_Alarms.md)