Zum Inhalt springen

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:

Eine vorhandene PagerDuty-Verbindung kann von diesen Standorten bearbeitet werden:

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

Wenn Sie API-Token als Authentifizierung-Methode auswählen, wird diese Schnittstelle angezeigt:

PagerDuty-Verbindungsconfiguration

Tipp

Felder mit einem Variablen-Icon 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 Variablen-Icon klicken, um eine Liste der vorhandenen Variablen anzuzeigen, aus denen Sie wählen können.

  • Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede PagerDuty-Verbindung eindeutig 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.

  • E-Mail: Geben Sie die E-Mail-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 fragt Sie, ob Sie die Änderungen wirklich 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 fragt Sie, ob Sie die Verbindung wirklich löschen möchten.

OAuth 2.0

Wenn Sie OAuth 2.0 als Authentifizierung-Methode auswählen, wird diese Schnittstelle angezeigt:

PagerDuty-Verbindungs-Konfiguration

Tipp

Felder mit einem Variablen-Symbol 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 Variablen-Symbol klicken, um eine Liste der vorhandenen Variablen anzuzeigen, aus der 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 OAuth 2.0.

  • E-Mail: Geben Sie die E-Mail-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.com lautet, geben Sie jbexample ein.

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

  • Service-Region: Wählen Sie die Service-Region 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 die Proxy-Einstellungen des privaten Agents 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 fragt Sie, ob 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 fragt Sie, ob 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. Weitere Einzelheiten finden Sie in den Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

  • Get Incident: Ruft ein Incident von PagerDuty ab und ist als Quelle in einer Operation vorgesehen.

  • Create Incident: Erstellt ein Incident in PagerDuty und ist als Ziel in einer Operation vorgesehen.

  • Update Incident: Aktualisiert ein Incident in PagerDuty und ist als Ziel in einer Operation vorgesehen.

  • Create Note: Erstellt eine Notiz, die mit einem Incident in PagerDuty verbunden ist, und ist als Ziel in einer Operation vorgesehen.

  • Manage Incidents: Aktualisiert mehrere Incidents in PagerDuty und ist als Ziel in einer Operation vorgesehen.

  • List Incident: Ruft mehrere Incidents von PagerDuty ab und ist als Quelle in einer Operation vorgesehen.

  • Create Status Update: Erstellt ein Statusupdate, das mit einem Incident in PagerDuty verbunden ist, und ist als Ziel in einer Operation vorgesehen.

  • Snooze Incident: Schlummert ein Incident in PagerDuty und ist als Ziel in einer Operation vorgesehen.