O AppSignal funciona com aplicações umbrella, mas há algumas coisas a ter em mente. A dependência deve ser adicionada a cada aplicação aninhada dentro da umbrella, e a configuração deve ser adicionada ao arquivo de configuração principal da umbrella.
Este guia aborda os primeiros passos para instalar o AppSignal nos seus projetos umbrella em Elixir e Phoenix. Para mais informações e passos seguintes, confira o guia principal de instalação.
Instalação
Adicione a dependência do AppSignal a cada aplicação que for usá-la. Isso inclui todas as aplicações Phoenix e todas as aplicações de backend que se comunicam com o banco de dados.
defp deps do
[
{:appsignal, "~> 2.0"}
]
end
Em seguida, execute o instalador do AppSignal no diretório raiz da umbrella para adicionar a configuração aos arquivos de configuração da aplicação umbrella.
$ mix appsignal.install YOUR_PUSH_API_KEY
Por padrão, cada aplicação aninhada em uma umbrella usa a configuração principal da umbrella, então as apps aninhadas devem ter acesso à configuração principal.
Phoenix
A instalação para Phoenix em uma aplicação umbrella é em sua maior parte a mesma de
configurar o AppSignal em uma aplicação Phoenix
“regular”. Uma coisa a ter em mente é
usar use Appsignal.Phoenix no arquivo de endpoint da sua aplicação. Se você tiver
várias aplicações Phoenix aninhadas, use o módulo em cada uma.
Se você inclui use Plug.Builder ou qualquer outro módulo que redefine a
função call/2, certifique-se de colocar a linha use Appsignal.Phoenix depois
disso.
defmodule AppsignalPhoenixExampleWeb.Endpoint do
use Phoenix.Endpoint, otp_app: :appsignal_phoenix_example
use Appsignal.Phoenix
# ...
end