Skip to main content
Das AppSignal-Add-on für Heroku 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.
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 ein.

​
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
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.
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.
Während Ihre App Requests verarbeitet, meldet sie Daten wie Throughput, Response Times und Fehler, die Sie in 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.
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.
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
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.
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.
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.

​
Add-on entfernen

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