Pular para o conteúdo principal
O pacote AppSignal for Elixir se integra ao Phoenix. Para configurar a integração, siga nosso guia de instalação. Esta página descreverá outras maneiras de configurar o AppSignal para o framework Phoenix. Para adicionar mais instrumentação personalizada à sua aplicação Phoenix, leia a documentação de instrumentação Elixir. Mais informações podem ser encontradas na documentação do pacote Hex do AppSignal.

Instalação

  1. A instrumentação do AppSignal para Phoenix faz parte de um pacote separado, que depende do pacote appsignal principal. Adicione o pacote appsignal_phoenix ao seu arquivo mix.exs.
  1. Em seguida, execute mix deps.get.
  2. Em seguida, execute mix appsignal.install YOUR_PUSH_API_KEY.
Após a instalação e configuração, o pacote AppSignal for Phoenix começa automaticamente a instrumentar requisições HTTP, ou seja, nenhuma configuração adicional é necessária. Para obter insights mais profundos, o AppSignal pode ser configurado para instrumentar channels e live views.

Channels

Instrumentação de channels com o handle de um channel

Requisições de channel recebidas podem ser instrumentadas envolvendo o código nas suas funções handle_in/3 com Appsignal.Phoenix.Channel.instrument/5:
Como alternativa, você pode usar function decorators para instrumentar channels. Embora sejam menos flexíveis do que a função de instrumentação, os decorators minimizam a quantidade de código que você precisa adicionar aos channels da sua aplicação.
Eventos de channels serão exibidos na aba “Background jobs”, mostrando o módulo do channel e o argumento de ação que você inseriu.

LiveView

Existem duas maneiras diferentes de instrumentar live views. Você pode usar nossos handlers automáticos de telemetria ou instrumentar manualmente seus handlers de live view com nossas funções helper.

Handlers automáticos de telemetria

Nota: A integração LiveView Telemetry está disponível a partir do AppSignal for Phoenix versão 2.1.0.
A integração LiveView Telemetry do AppSignal instrumenta automaticamente os eventos de live view. Para configurá-la, chame Appsignal.Phoenix.LiveView.attach/0 para anexar os handlers do LiveView Telemetry. Recomendamos chamar esta função no application.ex do seu app:
O AppSignal agora instrumentará automaticamente todos os eventos mount, handle_event e handle_param no namespace live_view, o que significa que você receberá insights tanto de desempenho quanto de erros nas suas live views.

Funções helper manuais

Se você já configurou a instrumentação automática por telemetria acima, não precisa instrumentar manualmente os handlers de live view.
Nota: As funções helper de LiveView estão disponíveis a partir do AppSignal for Elixir versão 1.13.0.
Uma ação de LiveView também pode ser instrumentada manualmente envolvendo seu conteúdo em um bloco Appsignal.Phoenix.LiveView.instrument/4. Dada uma live view que atualiza seu próprio estado a cada segundo, podemos adicionar instrumentação AppSignal envolvendo tanto as funções mount/2 quanto handle_info/2 com uma chamada a Appsignal.Phoenix.LiveView.instrument/4:
Chamar uma dessas funções no seu app agora criará automaticamente uma amostra que é enviada ao AppSignal. Essas amostras são exibidas no namespace :live_view.

Instrumentação de Plugs incluídos

Exceções em Plugs incluídos são automaticamente capturadas pelo AppSignal, mas as amostras de desempenho precisam ser configuradas manualmente usando os helpers de instrumentação personalizada ou decorators. Veja a documentação do Plug para mais informações.

Instrumentação personalizada

Adicione instrumentação personalizada para acompanhar código mais complexo e obter breakdowns mais completos de requisições lentas.