Pular para o conteúdo principal
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 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.

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

​
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 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 para o namespace de cada serviço suportado. Para exemplos de configuração de filtragem, veja o guia de configuração com CloudFormation.

​
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 ou configurar detecção de anomalias 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 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 para detalhes sobre frequências de relatório de métricas. Se precisar de ajuda, entre em contato.