> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Métricas do AWS CloudWatch

O AppSignal pode receber e visualizar métricas da sua infraestrutura AWS através do CloudWatch Metric Streams. Uma vez conectado, o AppSignal cria automaticamente [magic dashboards](/metrics/aws-dashboards) para os serviços AWS que você usa, fornecendo gráficos pré-construídos para as métricas mais importantes.

## Como funciona

O AWS CloudWatch coleta métricas de serviços rodando em sua conta AWS. Um CloudWatch Metric Stream exporta essas métricas através do Amazon Data Firehose para o endpoint HTTP do AppSignal no formato OpenTelemetry.

O fluxo de dados é assim:

**Serviços AWS** → **CloudWatch** → **Metric Stream** → **Data Firehose** → **AppSignal**

Uma vez que as métricas chegam, o AppSignal normaliza os nomes das métricas, aplica tags das dimensões do CloudWatch e as armazena como dados de série temporal. Quando o AppSignal detecta métricas de um serviço AWS suportado, ele cria um magic dashboard com gráficos pré-construídos para esse serviço.

## Configurar métricas do CloudWatch

Existem duas maneiras de conectar métricas do CloudWatch ao AppSignal:

### Configuração via Console

Siga as instruções para criar um stream de entrega Firehose, um bucket S3 de backup e um CloudWatch Metric Stream através do Console AWS.

Veja [Transmitir métricas do AWS CloudWatch através do Console AWS](/metrics/cloudwatch).

### CloudFormation

Implante um único template do CloudFormation que cria todos os recursos necessários em uma única etapa. Esta é a maneira mais rápida de começar e a mais fácil de reproduzir entre contas ou regiões AWS.

Veja [Transmitir métricas do AWS CloudWatch com CloudFormation](/metrics/cloudwatch-cloudformation).

## Magic dashboards

O AppSignal cria automaticamente dashboards quando detecta métricas do CloudWatch de um serviço AWS suportado. Cada dashboard é projetado para responder perguntas operacionais comuns: algo está quebrado, por que está lento, e preciso escalar?

Os dashboards colocam indicadores de saúde e erro primeiro, seguidos pela utilização de recursos, depois contexto operacional. As descrições dos gráficos explicam quais valores indicam um problema e o que fazer a respeito, então você não precisa ser um especialista em monitoramento AWS para interpretar seus dados.

O AppSignal suporta magic dashboards para mais de 45 serviços AWS em compute, bancos de dados, rede, armazenamento, mensageria e mais.

Veja [Magic dashboards da AWS](/metrics/aws-dashboards) para a lista completa de serviços suportados e seus gráficos.

## Escolher quais métricas transmitir

Os CloudWatch Metric Streams podem enviar métricas de todos os serviços AWS em sua conta ou um subconjunto filtrado. Transmitir todas as métricas é a opção mais simples. Se você só precisa de serviços específicos, filtre por namespace para limitar os dados enviados através do Firehose.

Para filtrar, adicione `IncludeFilters` ao recurso Metric Stream, especificando os namespaces do CloudWatch que você deseja (como `AWS/EC2`, `AWS/Lambda` ou `AWS/RDS`). Veja a página [Magic dashboards da AWS](/metrics/aws-dashboards) para o namespace de cada serviço suportado.

Para exemplos de configuração de filtragem, veja o [guia de configuração com CloudFormation](/metrics/cloudwatch-cloudformation#filter-specific-aws-services).

## Nomenclatura de métricas

O AppSignal normaliza os nomes das métricas do CloudWatch para minúsculas com sublinhados. O formato é o namespace normalizado seguido pelo nome da métrica em `snake_case`.

Por exemplo, `AWS/Lambda` `Duration` se torna `aws_lambda_duration`, e `AWS/Firehose` `DeliveryToS3.Success` se torna `aws_firehose_delivery_to_s3_success`.

Você pode usar esses nomes normalizados ao construir [dashboards personalizados](/metrics/dashboards) ou configurar [detecção de anomalias](/metrics/dashboards) no AppSignal.

## Tags e dimensões

Dimensões do CloudWatch (como `FunctionName`, `DBInstanceIdentifier` ou `ServiceName`) se tornam tags no AppSignal. Use essas tags para filtrar gráficos por recursos específicos.

Os magic dashboards usam filtros de tag com curinga para mostrar todos os recursos de um determinado tipo como linhas separadas no mesmo gráfico. Você também pode usar essas tags em dashboards personalizados para visualizações mais focadas.

## Configurações multi-região e multi-conta

Os CloudWatch Metric Streams operam dentro de uma única região AWS. Se você executa workloads em várias regiões, implante um Metric Stream e um stream de entrega Firehose separados em cada região. O [template do CloudFormation](/metrics/cloudwatch-cloudformation) pode ser implantado uma vez por região para configurar isso.

Para configurações multi-conta, crie um Metric Stream em cada conta. Use a mesma chave Push API de nível de App para enviar todas as métricas para uma única aplicação AppSignal, ou use chaves diferentes para separar métricas entre aplicações.

## Solução de problemas

Se as métricas não aparecerem no AppSignal após a configuração:

1. Verifique a aba **Monitoring** no seu stream de entrega Firehose no Console AWS. Procure por métricas **Incoming records** e **HTTP endpoint - Success** diferentes de zero.
2. Verifique se o estado do Metric Stream mostra **Running** no console do CloudWatch em **Metrics > Streams**.
3. Verifique o bucket S3 de backup para registros de entrega falha.
4. Confirme se o formato de saída está definido como **OpenTelemetry 1.0**. Outros formatos não são suportados.

Algumas métricas AWS (como métricas de armazenamento diário do S3) são reportadas com carimbos de data/hora mais antigos que duas horas e não aparecem em Metric Streams. Veja a [documentação AWS sobre CloudWatch Metric Streams](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) para detalhes sobre frequências de relatório de métricas.

Se precisar de ajuda, [entre em contato](mailto:support@appsignal.com).
