AppSignal fonctionne avec les applications umbrella, mais il y a certaines choses à garder à l’esprit. La dépendance doit être ajoutée à chaque application imbriquée à l’intérieur de l’umbrella, et la configuration doit être ajoutée au fichier de configuration principal de l’umbrella.
Ce guide passe en revue les premières étapes pour installer AppSignal dans vos projets umbrella Elixir et Phoenix. Pour plus d’informations et les étapes suivantes, consultez le guide d’installation principal.
Installation
Ajoutez la dépendance AppSignal à chaque application qui l’utilisera. Cela inclut toutes les applications Phoenix et toutes les applications backend qui communiquent avec la base de données.
defp deps do
[
{:appsignal, "~> 2.0"}
]
end
Ensuite, exécutez l’installeur d’AppSignal dans le répertoire racine de l’umbrella pour ajouter la configuration aux fichiers de configuration de l’application umbrella.
$ mix appsignal.install YOUR_PUSH_API_KEY
Par défaut, chaque application imbriquée dans un umbrella utilise la configuration principale de l’umbrella, donc les applications imbriquées devraient toutes avoir accès à la configuration principale.
Phoenix
L’installation pour Phoenix dans une application umbrella est globalement la même que la
configuration d’AppSignal pour une application Phoenix
« classique ». Une chose à garder à l’esprit
est d’utiliser use Appsignal.Phoenix dans le fichier endpoint de votre application. Si vous avez
plusieurs applications Phoenix imbriquées, utilisez le module dans chacune d’elles.
Si vous incluez use Plug.Builder ou tout autre module qui redéfinit la
fonction call/2, assurez-vous de placer la ligne use Appsignal.Phoenix après
celui-ci.
defmodule AppsignalPhoenixExampleWeb.Endpoint do
use Phoenix.Endpoint, otp_app: :appsignal_phoenix_example
use Appsignal.Phoenix
# ...
end