PagerDuty-Verbindung
Einführung
Eine PagerDuty-Verbindung, die mit dem PagerDuty-Connector erstellt wurde, ermöglicht den Zugriff auf PagerDuty. Sobald eine Verbindung konfiguriert ist, können Sie Instanzen von PagerDuty-Aktivitäten erstellen, die mit dieser Verbindung verknüpft sind, um sie entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) zu verwenden.
Erstellen oder Bearbeiten einer PagerDuty-Verbindung
Eine neue PagerDuty-Verbindung wird mit dem PagerDuty-Connector von einem dieser Standorte erstellt:
- Der Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette (siehe Designkomponentenpalette).
- Der Seite Globale Endpunkte (siehe Erstellen eines globalen Endpunkts in Globale Endpunkte).
Eine vorhandene PagerDuty-Verbindung kann von diesen Standorten bearbeitet werden:
- Der Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette (siehe Designkomponentenpalette).
- Der Registerkarte Komponenten im Projektbereich (siehe Aktionenmenü für Komponenten in Projektbereich Komponentenregister).
- Der Seite Globale Endpunkte (siehe Bearbeiten eines globalen Endpunkts in Globale Endpunkte).
Konfigurieren einer PagerDuty-Verbindung
Die Konfigurationsoberfläche für die PagerDuty-Verbindung hängt von der Authentifizierungs-Option ab, die Sie auswählen:
-
API-Token: Authentifizieren Sie die Verbindung mit einem API-Schlüssel.
-
OAuth 2.0: Authentifizieren Sie die Verbindung mit einer registrierten PagerDuty-App, die mit Scoped OAuth 2.0-Funktionalität konfiguriert ist (beschrieben in Voraussetzungen).
API-Token
Wenn Sie API-Token als Authentifizierung-Methode auswählen, wird die unten beschriebene Schnittstelle angezeigt.
Tipp
Felder mit einem Symbol für Variablen unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben oder indem Sie auf das Symbol für Variablen klicken, um ein Menü mit vorhandenen Variablen anzuzeigen, aus dem Sie auswählen können.
-
Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede PagerDuty-Verbindung einzigartig sein und darf keine Schrägstriche
/oder Doppelpunkte:enthalten. Dieser Name wird auch verwendet, um den PagerDuty-Endpunkt zu identifizieren, der sich sowohl auf eine spezifische Verbindung als auch auf deren Aktivitäten bezieht. -
Authentifizierung: Wählen Sie API-Token.
-
Email: Geben Sie die Email-Adresse ein, die mit dem REST-API-Schlüssel verknüpft ist.
-
API-Token: Geben Sie den PagerDuty REST API-Schlüssel ein. Informationen zu REST-API-Schlüsseln finden Sie in der Dokumentation von PagerDuty.
-
Proxy pro Endpunkt verwenden: Wenn Sie einen privaten Agenten verwenden, kann diese Einstellung ausgewählt werden, um die Proxy-Einstellungen des privaten Agenten zu verwenden.
-
Test: Klicken Sie, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisation Richtlinie Automatische Connector-Aktualisierung deaktivieren.
-
Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.
-
Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.
-
Löschen: Nachdem Sie eine vorhandene Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Verbindung löschen möchten.
OAuth 2.0
Wenn Sie OAuth 2.0 als Authentifizierung-Methode auswählen, wird die unten beschriebene Benutzeroberfläche angezeigt.
Tipp
Felder mit einem Symbol für Variablen unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben oder indem Sie auf das Symbol für Variablen klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.
-
Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede PagerDuty-Verbindung einzigartig sein und darf keine Schrägstriche
/oder Doppelpunkte:enthalten. Dieser Name wird auch verwendet, um den PagerDuty-Endpunkt zu identifizieren, der sich sowohl auf eine spezifische Verbindung als auch auf deren Aktivitäten bezieht. -
Authentifizierung: Wählen Sie OAuth 2.0.
-
Email: Geben Sie die Email-Adresse ein, die mit der PagerDuty-Instanz verknüpft ist.
-
Subdomain: Geben Sie die Kontosubdomain für Ihre PagerDuty-Instanz ein. Wenn Ihre Instanz-URL beispielsweise
jbexample.pagerduty.comist, geben Siejbexampleein. -
Client-ID: Geben Sie die Client-ID ein, die während der App-Registrierung ausgegeben wurde (beschrieben in Voraussetzungen).
-
Client-Geheimnis: Geben Sie das Client-Geheimnis ein, das während der App-Registrierung ausgegeben wurde (beschrieben in Voraussetzungen).
-
Bereich: Geben Sie den Text des Ausgewählten Berechtigungsbereichs ein, der während der App-Registrierung generiert wurde (beschrieben in Voraussetzungen).
-
Servicebereich: Wählen Sie den Servicebereich für die PagerDuty-Instanz, entweder US (Vereinigte Staaten) oder EU (Europa).
-
Proxy pro Endpunkt verwenden: Bei Verwendung eines privaten Agents kann diese Einstellung ausgewählt werden, um private Agent-Proxy-Einstellungen zu verwenden.
-
Test: Klicken Sie, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Auto Connector Update deaktivieren Organisationsrichtlinie.
-
Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.
-
Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.
-
Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Verbindung löschen möchten.
Nächste Schritte
Nachdem eine PagerDuty-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfsgrafik, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.
Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Palette der Entwurfskomponenten zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.
Diese Aktivitätstypen sind verfügbar:
-
Vorfall abrufen: Ruft einen Vorfall von PagerDuty ab und ist dafür gedacht, als Quelle in einem Vorgang verwendet zu werden.
-
Incident erstellen: Erstellt ein Incident in PagerDuty und ist als Ziel in einer Operation vorgesehen.
-
Incident aktualisieren: Aktualisiert ein Incident in PagerDuty und ist als Ziel in einer Operation vorgesehen.
-
Notiz erstellen: Erstellt eine Notiz, die mit einem Incident in PagerDuty verbunden ist, und ist als Ziel in einer Operation vorgesehen.
-
Incidents verwalten: Aktualisiert mehrere Incidents in PagerDuty und ist als Ziel in einer Operation vorgesehen.
-
Incident auflisten: Ruft mehrere Incidents von PagerDuty ab und ist als Quelle in einer Operation vorgesehen.
-
Statusaktualisierung erstellen: Erstellt eine Statusaktualisierung, die mit einem Incident in PagerDuty verbunden ist, und ist als Ziel in einer Operation vorgesehen.
-
Incident snoozen: Snoozt ein Incident in PagerDuty und ist als Ziel in einer Operation vorgesehen.