AppSignal funktioniert mit Umbrella-Anwendungen, aber es gibt einige Dinge zu beachten. Die Abhängigkeit sollte zu jeder verschachtelten Anwendung innerhalb des Umbrellas hinzugefügt werden, und die Konfiguration sollte in die Hauptkonfigurationsdatei des Umbrellas eingefügt werden.
Diese Anleitung beschreibt die ersten Schritte zur Installation von AppSignal in Ihren Umbrella-Elixir- und Phoenix-Projekten. Weitere Informationen und weitere Schritte finden Sie im Haupt-Installationsleitfaden.
Installation
Fügen Sie die AppSignal-Abhängigkeit zu jeder Anwendung hinzu, die sie verwenden wird. Dies umfasst alle Phoenix-Anwendungen und alle Backend-Anwendungen, die mit der Datenbank kommunizieren.
defp deps do
[
{:appsignal, "~> 2.0"}
]
end
Führen Sie dann den Installer von AppSignal im Stammverzeichnis des Umbrellas aus, um die Konfiguration zu den Konfigurationsdateien der Umbrella-Anwendung hinzuzufügen.
$ mix appsignal.install YOUR_PUSH_API_KEY
Standardmäßig verwendet jede verschachtelte Anwendung in einem Umbrella die Hauptkonfiguration des Umbrellas, sodass die verschachtelten Apps alle Zugriff auf die Hauptkonfiguration haben sollten.
Phoenix
Die Installation für Phoenix in einer Umbrella-Anwendung ist größtenteils dieselbe wie
beim Einrichten von AppSignal in einer „regulären“ Phoenix-Anwendung. Eine Sache, die zu beachten ist:
Verwenden Sie use Appsignal.Phoenix in der Endpoint-Datei Ihrer Anwendung. Wenn Sie
mehrere verschachtelte Phoenix-Anwendungen haben, verwenden Sie das Modul in jeder.
Wenn Sie use Plug.Builder oder ein anderes Modul einbinden, das die
Funktion call/2 neu definiert, stellen Sie sicher, dass Sie die Zeile use Appsignal.Phoenix nach
diesem platzieren.
defmodule AppsignalPhoenixExampleWeb.Endpoint do
use Phoenix.Endpoint, otp_app: :appsignal_phoenix_example
use Appsignal.Phoenix
# ...
end