- Uma integração do AppSignal: instale um pacote. Ele instrumenta sua aplicação e traz seu próprio agente, ou reporta por meio do collector.
- Um SDK do OpenTelemetry: instrumente sua aplicação você mesmo e envie os dados por meio do AppSignal Collector.
Linguagens e frameworks
Ruby
Integração do AppSignal. Instrumenta Rails, Sinatra, Sidekiq e outras bibliotecas Ruby sem alterações no código.
Elixir
Integração do AppSignal. Instrumenta Phoenix, Ecto, Oban e outras bibliotecas Elixir sem alterações no código.
Node.js
Integração do AppSignal, construída sobre o OpenTelemetry. Instrumenta Express, Fastify, NestJS, Prisma e outros pacotes.
Python
Integração do AppSignal, construída sobre o OpenTelemetry. Monitora Django, Flask, Celery e outras aplicações Python.
PHP
Integração do AppSignal, construída sobre o OpenTelemetry. Instrumenta Laravel e Symfony e envia dados por meio do AppSignal Collector.
Go
SDK do OpenTelemetry. Envia dados por meio do AppSignal Collector.
Java
SDK do OpenTelemetry. Envia dados por meio do AppSignal Collector.
JavaScript (navegador)
Rastreie erros de front-end e meça as Core Web Vitals de usuários reais. Breadcrumbs e vitals não precisam de configuração.
JavaScript
Rastreie erros em aplicações JavaScript de front-end, com plugins para breadcrumbs e integrações com frameworks.
Outras linguagens
Use o SDK do OpenTelemetry da sua linguagem e envie os dados por meio do AppSignal Collector.
Como os dados chegam ao AppSignal
Os dados de back-end seguem uma de três rotas:- Uma integração do AppSignal com seu agente: Ruby, Elixir, Node.js e Python. O pacote inicia o agente do AppSignal, um processo separado no mesmo host. O agente agrega seus dados antes de enviá-los e lê métricas de host. Quando o AppSignal está inacessível, ele armazena as payloads em disco e tenta novamente.
- Uma integração do AppSignal por meio do collector: o PHP sempre reporta dessa forma. Ruby (gem 5.0) e Python (1.8) podem mudar para essa rota, que é necessária para o distributed tracing. Você mantém a instrumentação da integração, e os dados trafegam como OpenTelemetry.
- Um SDK do OpenTelemetry por meio do collector: Go, Java e qualquer outra linguagem. Você adiciona o SDK e seus pacotes de instrumentação, e o collector prepara os dados.
Escolhendo uma rota
- Se a sua linguagem tem uma integração do AppSignal, instale-a.
- Se você usa Ruby ou Python e precisa de distributed tracing, mude a integração para o modo collector. O distributed tracing acompanha uma requisição entre os seus serviços e mostra cada trace como um mapa de serviços e uma linha do tempo.
- Se você usa Go, Java ou outra linguagem, use o SDK do OpenTelemetry com o collector.
- Se você já instrumenta com OpenTelemetry, mantenha essa instrumentação e aponte o SDK para o collector.
O que o agente e o collector fazem
Em todas as rotas, um agente ou o collector prepara seus dados antes que eles cheguem ao AppSignal. As integrações acrescentam ainda mais.O AppSignal Collector
O AppSignal Collector recebe dados de qualquer SDK do OpenTelemetry. Antes de enviar seus dados ao AppSignal, o collector:- Agrupa spans em traces e nomeia cada trace por namespace e action. Express, NestJS, Next.js, Django, Flask, Celery e Sidekiq recebem nomes específicos do framework.
- Calcula métricas de throughput, duração e erros a partir de cada trace.
- Remove valores de queries SQL e comandos Redis.
- Filtra parâmetros de requisição, cabeçalhos e dados de sessão, e descarta os erros, actions e namespaces que você escolher ignorar.
- Vincula cada linha de log ao trace de onde ela veio.
- Aceita métricas do OpenTelemetry, quer o seu SDK as reporte como valores cumulativos ou delta.
- Armazena os dados em disco quando não consegue alcançar o AppSignal e os envia mais tarde. Os dados na fila são mantidos por até uma hora.
- Pode coletar métricas de host do servidor Linux em que roda.
Integrações do AppSignal
As integrações fazem a instrumentação por você e coletam dados que os SDKs do OpenTelemetry não coletam:- Instrumentam frameworks e bibliotecas sem alterações no código.
- Reportam métricas de runtime a cada minuto, como a coleta de lixo do Ruby, as filas do Sidekiq, a memória da VM do Erlang e o tamanho do heap do Node.js. Essas métricas criam Intelligence dashboards para você.
- Reportam métricas de host por padrão, em Ruby, Elixir, Node.js e Python.
- Incluem helpers para adicionar tags, reportar erros, enviar métricas personalizadas e enviar logs.
- Incluem ferramentas de linha de comando para instalar a integração, enviar dados de teste e verificar sua configuração.
- Criam deploy markers a partir da opção
revision.
Ferramentas de telemetria
Ferramentas independentes que monitoram processos e hosts e coletam telemetria fora do código da sua aplicação.Wrap
Monitore qualquer processo em execução nos seus servidores, como cron jobs ou servidores de banco de dados.
Collector
Colete e processe dados do OpenTelemetry antes de enviá-los ao AppSignal.
Agente independente
Colete métricas de host e dados de StatsD e NGINX de servidores que não executam sua aplicação.