Zum Hauptinhalt springen
AppSignal kann Benachrichtigungen über neue Incidents an mehrere Dienste senden; sehen Sie sich unsere vollständige Liste auf der Seite Integrations an. Wir bieten auch Webhooks für diese Benachrichtigungen an, damit Sie neue Incidents in Ihrem eigenen System verarbeiten können. Um einen Webhook zu empfangen, gehen Sie in Ihrer AppSignal-Organisation zu Notifications und wählen Sie Add new notifier aus. Wählen Sie in der Liste der Notifier Webhook aus. Geben Sie unter Webhook URL die URL ein, an der Sie Ihre Webhook-Daten empfangen möchten.
Die URL muss zu einer öffentlichen Internetadresse aufgelöst werden. AppSignal lehnt URLs ab, die auf localhost, einen privaten Netzwerkbereich oder eine andere interne Adresse verweisen. AppSignal prüft die Adresse außerdem vor jeder Anfrage. Eine gespeicherte URL, die zu einer internen Adresse aufgelöst wird, erhält keine Benachrichtigungen, und das Log des Notifiers zeigt “Request blocked: URL does not resolve to a public address”. Um wieder Benachrichtigungen zu erhalten, ändern Sie die URL in eine öffentliche Adresse.
Einstellungen des Webhook-Notifiers mit den Feldern Name, Webhook URL, Webhook Headers und Webhook verification token

Einstellungen eines Webhook-Notifiers, einschließlich seiner URL und seines Verifizierungstokens

Es sind mehrere Webhooks verfügbar. Wählen Sie unter Send notifications for the following events aus, welche Payloads der Webhook empfängt: Deploys, Errors, Performance und Triggers.
Abschnitte des Webhook-Notifiers, um den Notifier auf Apps einzugrenzen und seine Events auszuwählen

Wählen Sie aus, welche Apps und Events der Webhook-Notifier abdeckt

AppSignal-Webhook-Anfragen verifizieren

Um die Sicherheit Ihrer Anwendung zu gewährleisten, können Sie überprüfen, ob eingehende Webhook-Anfragen tatsächlich von AppSignal stammen. Die Verifizierung erfolgt mithilfe eines Webhook-Verifizierungstokens, um die Signatur der Anfrage zu validieren.

Ihren Webhook-Verifizierungstoken finden

  1. Gehen Sie in Ihrer AppSignal-Organisation zu Notifications.
  2. Wählen Sie Manage neben dem Webhook-Notifier aus, den Sie verifizieren möchten.
  3. Suchen Sie unter Settings for this notifier das Webhook verification token.
Dieses Token wird verwendet, um zu überprüfen, dass die Webhook-Anfrage von AppSignal stammt.

Eine Anfrage verifizieren

Wenn AppSignal eine Webhook-Anfrage sendet, enthält sie eine Signatur im Header X-Appsignal-Signature. Sie können die Anfrage wie folgt validieren:
  1. Verketten Sie das AppSignal-Webhook-Verifizierungstoken mit dem rohen Request-Body.
  2. Erzeugen Sie einen SHA256-Hash des verketteten Strings.
  3. Vergleichen Sie den erzeugten Hash mit dem Wert im Header X-Appsignal-Signature.
Wenn die Hashes übereinstimmen, kann die Anfrage als von AppSignal stammend verifiziert werden.

Beispielimplementierungen

Nachfolgend einige Beispiele dafür, wie Sie überprüfen können, ob eine Anfrage von AppSignal stammt, in Ruby, Elixir, Node.js und Python. Hinweis: Die folgenden Beispiele dienen nur zur Veranschaulichung; Sie müssen sie je nach den Frameworks, Integrationen und Abhängigkeiten Ihrer App möglicherweise anpassen.

Deploy-Marker

Felder

Unterfelder des Deploy-Markers

Exception-Incidents

Felder

Unterfelder der Exception

Metadaten-Felder

Sie können eigene Metadaten hinzufügen, indem Sie Traces taggen.

Performance traces

Felder

Unterfelder der Performance

Metadaten-Felder

Sie können eigene Metadaten hinzufügen, indem Sie Traces taggen.

Anomaly detection


Liste der Integrationen