Pular para o conteúdo principal
O AppSignal monitora aplicações e serviços criados com as linguagens e frameworks abaixo. Aplicações de back-end enviam seus dados por meio de um agente do AppSignal ou do AppSignal Collector. É ali que os dados são preparados para o AppSignal. Você escolhe como eles chegam lá:
  • 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.
Nas duas rotas, os traces chegam agrupados, nomeados, sanitizados e filtrados. O que o agente e o collector fazem lista o que acontece em cada rota antes que seus dados cheguem ao AppSignal.

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.
Usa uma linguagem que não está listada aqui? Instrumente-a com OpenTelemetry e envie os dados para o AppSignal.

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.
O collector roda hospedado pelo AppSignal ou nos seus próprios servidores. O collector hospedado não exige configuração nem manutenção, o que o torna adequado para deploys serverless e em plataformas como serviço (PaaS). Um collector self-hosted processa seus dados antes que eles saiam da sua rede e pode reportar métricas de host do servidor em que roda.

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.