> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AppSignal für Elixir installieren

Bitte folgen Sie zuerst dem [Installationsleitfaden](/guides/new-application), wenn Sie eine neue Anwendung zu AppSignal hinzufügen.

## Voraussetzungen

Bevor Sie das AppSignal-Paket kompilieren können, stellen Sie sicher, dass die Build-/Kompilierungs-Tools für Ihr System installiert sind. Bitte prüfen Sie die Seite [Unterstützte Betriebssysteme](/support/operating-systems) für alle möglicherweise erforderlichen Systemabhängigkeiten.

## Installation

Die Installation des AppSignal-Pakets in Ihrer Elixir-Anwendung erfordert einige manuelle Schritte. Derzeit unterstützt AppSignal Phoenix, Plug und reine Elixir-Anwendungen.

Wenn AppSignal Ihren Anwendungsfall nicht unterstützt oder wenn Sie ein Problem mit der Dokumentation finden, zögern Sie nicht, [uns zu kontaktieren][support]. Sie können auch einen Pull-Request in unserem öffentlichen [Elixir-Repository][elixir-repo] erstellen.

### Installation des Pakets

<Note>
  📖 **Hinweis**: Wenn Sie eine Umbrella-Anwendung betreiben, lesen Sie auch unseren
  [Installationsleitfaden für Umbrella-Anwendungen](/elixir/installation/umbrella).
</Note>

<Tip>
  **Hinweis**: Wenn Sie das [Phoenix-Framework][phoenix] oder [Plug][plug] verwenden,
  fahren Sie mit den Anleitungen [AppSignal in Phoenix
  integrieren](/elixir/integrations/phoenix) oder [AppSignal in
  Plug integrieren](/elixir/integrations/plug) fort.
</Tip>

1. Fügen Sie zunächst `appsignal` zu Ihrer Abhängigkeitsliste in `mix.exs` hinzu.

<CodeGroup>
  ```elixir Elixir theme={null}
  # mix.exs
  def deps do
    [
      {:appsignal, "~> 2.8"}
    ]
  end
  ```
</CodeGroup>

2. Führen Sie dann `mix deps.get` aus.
3. Führen Sie anschließend `mix appsignal.install YOUR_PUSH_API_KEY` aus oder folgen Sie der [Anleitung zur manuellen Konfiguration](#configuration).

Nach Abschluss der Installation starten Sie Ihre Anwendung. Wenn die
AppSignal-OTP-Anwendung startet, sucht sie nach einer gültigen Konfiguration (z. B. einem
AppSignal-Push-API-Key) und startet den AppSignal-Agenten.

Wenn keine gültige Konfiguration gefunden wird, wird eine Warnung protokolliert. Siehe
den Abschnitt [Konfiguration](#configuration), um zu erfahren, wie der AppSignal-Agent
vollständig konfiguriert wird.

### Konfiguration

Bevor das AppSignal-Paket funktioniert, müssen Sie es konfigurieren. Um Daten an
AppSignal senden zu können, müssen Sie zunächst [ein Konto auf
AppSignal.com erstellen](https://appsignal.com/users/sign_up). Oder, wenn Sie bereits ein
Konto haben, klicken Sie auf "add app" auf
[AppSignal.com/accounts](https://appsignal.com/accounts).

Während des Installationsprozesses können Sie den Befehl `mix appsignal.install`
mit dem hexadezimalen [Push-API-Key](/appsignal/terminology#push-api-key)
ausführen oder AppSignal manuell mithilfe der untenstehenden Anleitung konfigurieren.

Weitere Informationen zur Konfiguration des AppSignal-Pakets für Elixir finden Sie in unserer
[Konfigurationsdokumentation](/elixir/configuration).

#### Manuelle Konfiguration

Wenn Sie AppSignal manuell konfigurieren möchten, müssen Sie den
AppSignal-Push-API-Key, den Sie im Installationsprozess erhalten, in die
Konfigurationsdatei `config/config.exs` Ihrer Anwendung einfügen.

Mit der AppSignal-Konfiguration können Sie auch einen Anwendungsnamen, eine Umgebung
und mehr konfigurieren.

<CodeGroup>
  ```elixir Elixir theme={null}
  # config/config.exs
  config :appsignal, :config,
    otp_app: :appsignal_phoenix_example,
    name: "AppsignalPhoenixExample",
    push_api_key: "your-push-api-key",
    env: Mix.env,
    active: true
  ```
</CodeGroup>

Alternativ können Sie AppSignal mit OS-Umgebungsvariablen konfigurieren.

<CodeGroup>
  ```sh Shell theme={null}
  export APPSIGNAL_OTP_APP="appsignal_phoenix_example"
  export APPSIGNAL_PUSH_API_KEY="your-push-api-key"
  export APPSIGNAL_APP_NAME="AppsignalPhoenixExample"
  export APPSIGNAL_APP_ENV="prod"
  ```
</CodeGroup>

Weitere Informationen zur Konfiguration des AppSignal-Pakets für Elixir finden Sie auf
unserer Seite [Konfigurationsoptionen](/elixir/configuration).

### Starten Sie Ihre Anwendung!

Sobald Sie diese Anleitung abgeschlossen haben, ist Ihre Anwendung bereit,
von AppSignal überwacht zu werden!

Starten Sie Ihre Anwendung und führen Sie einige Anfragen darauf aus. Indem Sie
einen oder zwei Fehler auslösen, testen Sie auch die Fehlerberichterstattung.

[Kontaktieren Sie uns][support], wenn Sie Fragen zur Installation haben oder
während der Installation Probleme aufgetreten sind.

### Optional: Phoenix-Instrumentierung hinzufügen

Lesen Sie mehr darüber, wie Sie mehr Instrumentierung in Ihre Phoenix-Anwendung
integrieren können, in unserer Anleitung [Phoenix
integrieren](/elixir/integrations/phoenix).

### Optional: Plug-Instrumentierung hinzufügen

Lesen Sie mehr darüber, wie Sie mehr Instrumentierung in Ihre Plug-Anwendung integrieren können, in unserer Anleitung [Plug integrieren](/elixir/integrations/plug).

### Optional: Benutzerdefinierte Instrumentierung hinzufügen

Fügen Sie Ihrer Anwendung benutzerdefinierte Instrumentierung hinzu, um einen tieferen Einblick
in das zu erhalten, was in Ihrer Anwendung passiert. Lesen Sie mehr über benutzerdefinierte Instrumentierung
in unserer [Instrumentierungs-Dokumentation](/elixir/instrumentation).

***

<Note>
  📖 Fahren Sie mit unserem [Installationsleitfaden](/guides/new-application) fort.
</Note>

## Deinstallation

Deinstallieren Sie AppSignal aus Ihrer App, indem Sie den folgenden Schritten folgen. Wenn diese Schritte abgeschlossen sind, sendet Ihre App keine Daten mehr an die AppSignal-Server.

1. Löschen Sie in der `mix.exs` Ihrer App die Zeile `{:appsignal, "~> 2.0"}`.

2. Führen Sie `mix deps.get` aus, um Ihre `mix.lock` mit dem Zustand der entfernten Pakete zu aktualisieren.

3. Entfernen Sie alle AppSignal-[Konfigurationsdateien](/elixir/configuration/) aus Ihrer App.
   * Speicherort der Konfigurationsdatei: `config/appsignal.exs`

   * Und alle Verweise darauf in anderen Dateien in `config/*.exs`

4. Entfernen Sie alle System-Umgebungsvariablen von Ihren Entwicklungs-, Staging-, Produktions- usw. Hosts.
   * Umgebungsvariablen mit dem Präfix `APPSIGNAL_`

   * Umgebungsvariable [`APP_REVISION`](/elixir/configuration/options#option-revision)

5. Committen, deployen und starten Sie Ihre App neu.
   * Damit stellen Sie sicher, dass die AppSignal-Server keine Daten mehr von Ihrer App empfangen.

6. Optional: Stellen Sie sicher, dass keine `appsignal-agent`-Prozesse im Hintergrund laufen.
   * Prüfen Sie die Ausgabe von `ps aux | grep appsignal-agent` und beenden Sie die noch laufenden Prozesse.

7. Schließlich [entfernen Sie die App](/guides/application/deleting-applications) auf AppSignal.com.

<Note>
  📖 Fahren Sie mit unserem [Deinstallationsleitfaden](/guides/application/deleting-applications) fort.
</Note>

[support]: mailto:support@appsignal.com

[elixir-repo]: https://github.com/appsignal/appsignal-elixir

[phoenix]: http://www.phoenixframework.org/

[plug]: https://github.com/elixir-plug/plug