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

# PagerDuty

> Integration mit PagerDuty, um Wirespeed-Fälle als Incidents zu synchronisieren

## Vorteile der Integration von PagerDuty und Wirespeed

* PagerDuty-Incidents automatisch erstellen, wenn Wirespeed-Fälle eskaliert werden
* Incidents an den bei der Einrichtung ausgewählten PagerDuty-Service weiterleiten
* Den Schweregrad von Wirespeed-Fällen auf PagerDuty-Incidents mit hoher oder niedriger Dringlichkeit abbilden
* PagerDuty-Incidents auflösen, wenn die zugehörigen Wirespeed-Fälle geschlossen werden
* Bestätigungen, Auflösungen und Notizen zwischen PagerDuty-Incidents und Wirespeed-Fällen synchronisieren

## Funktionsweise

* Wenn ein Wirespeed-Fall eskaliert wird, erstellt Wirespeed einen Incident im konfigurierten PagerDuty-Service. Der Incident enthält die Details des Wirespeed-Falls und verwendet die konfigurierte Titelvorlage für Fall-Incidents, sofern eine angegeben ist.
* Wirespeed bildet Fälle mit kritischem und hohem Schweregrad auf Incidents mit hoher Dringlichkeit ab. Andere Schweregrade erzeugen Incidents mit niedriger Dringlichkeit.
* Wenn ein Wirespeed-Fall geschlossen wird, löst Wirespeed den zugehörigen PagerDuty-Incident auf. Wird der Fall mit Notizen geschlossen, fügt Wirespeed die Abschlussnotiz zum Incident hinzu.
* Wenn einem eskalierten Wirespeed-Fall eine Detektion hinzugefügt wird, fügt Wirespeed dem zugehörigen PagerDuty-Incident eine Notiz hinzu.
* Wirespeed erstellt ein Webhook-Abonnement für den ausgewählten PagerDuty-Service. Über diesen Webhook schließt das Auflösen eines Incidents den zugehörigen Wirespeed-Fall, das Bestätigen eines Incidents markiert den Fall als beantwortet, und das Kommentieren eines Incidents fügt dem Fall eine Notiz hinzu.

## Anforderungen

* Ein aktives Wirespeed-Konto mit der Berechtigung, Integrationen hinzuzufügen und zu konfigurieren
* Ein aktives PagerDuty-Konto und ein PagerDuty-Benutzer mit Zugriff auf den Service, der für Wirespeed-Incidents verwendet wird
* Die Berechtigung, Incidents und Webhook-Abonnements für den ausgewählten PagerDuty-Service zu verwalten

Wirespeed verwendet das klassische OAuth von PagerDuty und fordert den Scope `write` an. Der `write`-Scope des klassischen PagerDuty-OAuth umfasst Lese- und Schreibzugriff. Wirespeed benötigt Schreibzugriff, um Incidents zu erstellen und zu aktualisieren und Webhook-Abonnements zu verwalten. Lesezugriff wird benötigt, um verfügbare Services und bestehende Webhook-Abonnements aufzulisten.

Für die Integration müssen Sie keinen API-Schlüssel erstellen oder eingeben. PagerDuty stellt nach der Autorisierung ein OAuth-Zugriffstoken aus, das Wirespeed verschlüsselt im Speicher für Integrationszugangsdaten ablegt. Die Verbindung ist an den PagerDuty-Benutzer gebunden, der sie autorisiert. Wirespeed kann daher nur auf Services zugreifen und Aktionen ausführen, für die dieser Benutzer berechtigt ist.

## Support

Wenn Sie Hilfe bei dieser Integration benötigen, nutzen Sie die Schaltfläche **Chat** in Wirespeed, um unsere Techniker zu kontaktieren, oder senden Sie eine E-Mail an [support@wirespeed.co](mailto:support@wirespeed.co).

## Schritt-für-Schritt-Anleitung zur Integration

### In PagerDuty

Sie müssen keine PagerDuty-Service-Integration erstellen und keinen Integrationsschlüssel kopieren. Vergewissern Sie sich vorab, dass der gewünschte PagerDuty-Service bereits existiert und Ihr PagerDuty-Benutzer Incidents und Webhook-Abonnements dafür verwalten kann. PagerDuty fordert Sie während der Einrichtung auf, Wirespeed über OAuth zu autorisieren.

### In Wirespeed

1. Melden Sie sich bei Wirespeed an und navigieren Sie zu **Integrationen** > [**Integration hinzufügen**](https://app.wirespeed.co/settings/integrations?tab=browse)
2. Wählen Sie **PagerDuty** und klicken Sie auf **Integrieren**
3. Prüfen Sie im PagerDuty-Autorisierungstab den angeforderten OAuth-Scope `write` und klicken Sie auf **Accept**, um Wirespeed als Ihr PagerDuty-Benutzer zu autorisieren
4. Kehren Sie zu Wirespeed zurück und aktualisieren Sie die Seite [**Integrationen**](https://app.wirespeed.co/settings/integrations)
5. Wählen Sie die neu hinzugefügte **PagerDuty**-Integration aus
6. Wählen Sie den PagerDuty-**Service**, in dem Wirespeed Incidents erstellen soll
7. Geben Sie optional eine **Titelvorlage für Fall-Incidents** ein, um die Incident-Titel anzupassen
8. Klicken Sie auf **Speichern**

Beim Speichern der Konfiguration erstellt Wirespeed ein Webhook-Abonnement für den ausgewählten Service und abonniert die Ereignisse `incident.resolved`, `incident.acknowledged` und `incident.annotated`.

## Deinstallation

1. Melden Sie sich bei Wirespeed an und navigieren Sie zu [**Integrationen**](https://app.wirespeed.co/settings/integrations)
2. Wählen Sie die verbundene **PagerDuty**-Integration aus
3. Klicken Sie auf **Löschen**
4. Geben Sie den angeforderten Bestätigungstext ein und bestätigen Sie das Löschen

Durch das Löschen der Integration wird die Synchronisierung zwischen Wirespeed und PagerDuty beendet und das von Wirespeed erstellte Webhook-Abonnement entfernt. Bestehende PagerDuty-Incidents und Wirespeed-Fälle werden nicht gelöscht.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.