> ## 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.

# Heroku-Add-on

> Richten Sie AppSignal für Ihre Heroku-Apps mit dem Add-on ein, teilen Sie es über mehrere Apps hinweg und verwalten Sie die Bereitstellung.

Das [AppSignal-Add-on für Heroku](https://elements.heroku.com/addons/appsignal) richtet AppSignal für Ihre Heroku-App ein, ohne dass eine manuelle Konfiguration nötig ist. Wenn Sie es zu einer App hinzufügen, erstellt AppSignal ein Konto, generiert einen Push API key und legt diesen Key als Config Var `APPSIGNAL_PUSH_API_KEY` der App fest. Ihre AppSignal-Integration liest den Key automatisch aus und beginnt mit dem Reporting.

Sie können ein Add-on an mehrere Heroku-Apps anhängen, sodass sie an dasselbe AppSignal-Konto berichten. Das ist hilfreich, wenn sich ein Projekt über mehrere Apps erstreckt, etwa eine Web-App und einen Background Worker.

<Note>
  Das Add-on meldet die eigenen Daten Ihrer Anwendung (Fehler und Performance)
  über Ihre Sprachintegration. Um auch Heroku-Plattformdaten wie
  Plattformfehler, Host-Metriken und automatische Dashboards zu erfassen,
  richten Sie zusätzlich einen [Log Drain oder Telemetry
  Drain](/heroku/setup) ein.
</Note>

## Add-on installieren

Sie können das Add-on über das Heroku-Dashboard oder die Heroku-CLI bereitstellen. Das Add-on ist im Heroku Elements Marketplace als **AppSignal APM** gelistet.

So stellen Sie es über das Heroku-Dashboard bereit:

1. Öffnen Sie Ihre App in Heroku und wählen Sie **Configure Add-ons** unter **Installed Add-ons** auf dem Tab **Overview**. Dadurch öffnet sich der Tab **Resources** der App.
2. Suchen Sie im Feld **Add-on Services** nach **AppSignal APM** und wählen Sie es aus den Ergebnissen aus.
3. Wählen Sie einen Plan unter **Plan name** aus und wählen Sie dann **Submit Order Form**.

Heroku stellt das Add-on bereit, und **AppSignal APM** erscheint in der Liste der Add-on-Services auf dem Tab **Resources**.

So stellen Sie es über die Heroku-CLI bereit:

```bash Bash theme={null}
heroku addons:create appsignal:<PLAN> --app <YOUR_APP_NAME>
```

Ersetzen Sie `<PLAN>` durch den gewünschten Plan und `<YOUR_APP_NAME>` durch den Namen Ihrer Heroku-App. Um die verfügbaren Pläne aufzulisten, führen Sie `heroku addons:plans appsignal` aus.

Die Bereitstellung dauert einige Sekunden. Wenn sie abgeschlossen ist, tut AppSignal Folgendes:

* Es erstellt ein AppSignal-Konto für die App.
* Es generiert einen Push API key und legt ihn als Config Var `APPSIGNAL_PUSH_API_KEY` der App fest. Sie finden ihn unter **Config Vars** auf dem Tab **Settings** der App.

Sie müssen den App-Namen oder den Push API key nicht im Code Ihrer Anwendung festlegen. Das Add-on stellt den Key über die konfigurierten Variablen von Heroku bereit, und Ihre App erscheint in AppSignal unter ihrem Heroku-App-Namen.

Nach der Bereitstellung kann es einige Minuten dauern, bis Ihre Anwendung in AppSignal erscheint. Sie erscheint, sobald AppSignal die ersten Daten von Ihrer App empfängt.

## AppSignal von Heroku aus öffnen

Durch die Bereitstellung des Add-ons wird ein AppSignal-Konto für Ihre App erstellt. Um es zu öffnen, wählen Sie den Link **AppSignal APM** unter **Installed Add-ons** auf dem Tab **Overview** Ihrer Heroku-App. Heroku meldet Sie über Single Sign-on bei AppSignal an, wo Sie die Apps sehen können, die an dieses Konto berichten, zusammen mit deren Fehlern, Performance und Metriken.

<Note>
  Es kann einige Minuten dauern, bis Ihre App nach dem Öffnen von AppSignal
  ihre ersten Daten meldet. Sie müssen die App nicht erneut in AppSignal
  erstellen. Warten Sie, bis sie erscheint. Sobald AppSignal Daten empfängt,
  zeigt der Installationsassistent eine Erfolgsmeldung an, die bestätigt, dass
  die App einsatzbereit ist.
</Note>

Während Ihre App Requests verarbeitet, meldet sie Daten wie Throughput, Response Times und Fehler, die Sie in [Dashboards](/metrics/dashboards) einsehen können. Um dasselbe Dashboard für mehrere Apps wiederzuverwenden, importieren Sie es aus einer JSON-Definition: Wählen Sie **Add dashboard**, fügen Sie das Dashboard-JSON ein und wählen Sie **Create dashboard**.

## Mehrere Apps mit einem Add-on überwachen

Hängen Sie das Add-on an eine weitere Heroku-App an, damit beide Apps mit demselben Push API key an dasselbe AppSignal-Konto berichten.

<Note>
  Das Anhängen eines bestehenden Add-ons teilt einen Push API key von
  AppSignal über mehrere Apps hinweg. Würden Sie stattdessen jeder App ein
  eigenes AppSignal-Add-on hinzufügen, entstünden pro App ein separates Konto
  und ein separater Push API key, und die Apps wären nicht miteinander
  verknüpft.
</Note>

So hängen Sie es über das Heroku-Dashboard an:

1. Öffnen Sie die App, die das Add-on besitzt, und wählen Sie **Configure Add-ons** auf ihrem Tab **Overview**. Dadurch öffnet sich der Tab **Resources**.
2. Suchen Sie in der Tabelle **Add-on Services** die Zeile **AppSignal APM**. Öffnen Sie in der Spalte **Attachments** das Menü **Attached as APPSIGNAL** und wählen Sie **Manage attachments**.
3. Wählen Sie im Panel **Add-on Attachments** die Option **Attach to another app**, geben Sie dann den Namen der App ein und wählen Sie sie aus den Ergebnissen aus.

So hängen Sie es über die Heroku-CLI an:

```bash Bash theme={null}
heroku addons:attach <APPSIGNAL_ADDON_NAME> --app <TARGET_APP_NAME>
```

Ersetzen Sie `<APPSIGNAL_ADDON_NAME>` durch den Namen des bestehenden AppSignal-Add-ons und `<TARGET_APP_NAME>` durch die App, an die Sie es anhängen möchten.

Beide Apps teilen sich nun dieselbe Config Var `APPSIGNAL_PUSH_API_KEY` und berichten an dasselbe AppSignal-Konto. Die Apps bleiben in Heroku unabhängig voneinander. Beide können zum Beispiel Production-Apps sein. Wie bei der ursprünglichen Installation kann es bei der zweiten App einige Minuten dauern, bis sie in AppSignal erscheint.

### Wie das Konto benannt wird

Das Konto übernimmt seinen Namen von der ersten App, auf der das Add-on bereitgestellt wurde. Von Add-ons erstellte Konten funktionieren anders als reguläre AppSignal-Konten, daher kann dieser Name danach nicht mehr geändert werden. Stellen Sie das Add-on auf der App bereit, deren Namen das Konto verwenden soll.

## Wenn das Add-on nicht zu funktionieren scheint

Das Add-on legt Ihren Push API key als Config Var in Heroku fest, den Ihre Integration als Umgebungsvariable ausliest. Wenn Ihre Anwendung ebenfalls einen Push API key in ihrem eigenen Code festlegt, kann dieser Wert den des Add-ons überschreiben, sodass Ihre App an ein anderes Konto berichtet.

<Note>
  Wenn Ihre App nicht unter dem Konto des Add-ons erscheint, prüfen Sie, ob
  Ihre Anwendung einen AppSignal Push API key im Code festlegt. In Ruby kann
  sich das zum Beispiel in einer Datei `appsignal.rb` oder einem Block
  `Appsignal.configure` befinden. Entfernen Sie ihn, damit Ihre App den Key aus
  der Config Var von Heroku verwendet.
</Note>

Die genaue Priorität hängt von der Ladereihenfolge der Konfiguration Ihrer Sprache ab. Details finden Sie in der Dokumentation zur Ladereihenfolge Ihrer Sprache, zum Beispiel der [Ladereihenfolge für Ruby](/ruby/configuration/load-order).

## Add-on entfernen

<Warning>
  Wenn Sie das Add-on entfernen, verlieren Sie den Zugriff auf das zugehörige
  AppSignal-Konto und dessen Daten. Wenn Sie das Add-on erneut bereitstellen,
  generiert AppSignal einen neuen Push API key und ein neues Konto, und Ihre
  vorherigen Daten werden nicht übernommen. Exportieren Sie zuerst alle Daten,
  die Sie behalten möchten.
</Warning>

Sie können das Add-on nicht löschen, solange mehr als eine App daran angehängt ist. Wenn Sie es versuchen, zeigt Heroku den Fehler „Resource must be detached from all other apps before deprovisioning" an. Trennen Sie zuerst die anderen Apps und löschen Sie das Add-on dann von der App, der es gehört. Die besitzende App wird in der Spalte **Plan** als **Billed to** angezeigt.

Das Trennen einer App löscht das Add-on oder seine Daten nicht. Es sorgt nur dafür, dass diese App nicht mehr über das gemeinsam genutzte Add-on berichtet.

So entfernen Sie es über das Heroku-Dashboard:

1. Öffnen Sie eine angehängte App und wählen Sie **Configure Add-ons** auf ihrem Tab **Overview**. Dadurch öffnet sich der Tab **Resources**.
2. Öffnen Sie in der Tabelle **Add-on Services** das Menü der Attachments von **AppSignal APM** in der Spalte **Attachments** und wählen Sie **Manage attachments**.
3. Wählen Sie im Panel **Add-on Attachments** das Entfernen-Symbol neben jeder App außer der besitzenden App aus und bestätigen Sie jede mit **Remove Attachment**.
4. Öffnen Sie auf dem Tab **Resources** der besitzenden App das Menü **Actions** der Zeile **AppSignal APM** und wählen Sie **Delete Add-on**.
5. Geben Sie den Namen der App zur Bestätigung ein und wählen Sie dann **Remove add-on**.

So entfernen Sie es über die Heroku-CLI, indem Sie jedes Attachment trennen und das Add-on anschließend zerstören:

```bash Bash theme={null}
heroku addons:detach <ATTACHMENT_NAME> --app <APP_NAME>
heroku addons:destroy <APPSIGNAL_ADDON_NAME> --app <APP_NAME>
```

Ersetzen Sie `<ATTACHMENT_NAME>` durch das zu entfernende Attachment, `<APP_NAME>` durch die App, zu der es gehört, und `<APPSIGNAL_ADDON_NAME>` durch den Namen des AppSignal-Add-ons.