App für den „ Slack “-Benachrichtigungskanal

Sie können eine App für den Benachrichtigungskanal „ Slack “ erstellen, um Echtzeit-Benachrichtigungen von Instana an diesen Kanal unter Slack zu senden.

Hinweis: Die App „ IBM “ ( Instana ) für „ Slack “ ist nun offiziell zertifiziert und im „ Slack Marketplace“ gelistet. Sie können es direkt über den Slack -Marktplatz oder über den in diesem Dokument beschriebenen Installationsablauf unter Instana installieren.

Erstellen einer App für den Benachrichtigungskanal „ Slack “

Um eine App für den Benachrichtigungskanal „ Slack “ zu erstellen, führen Sie die folgenden Schritte aus:

  1. Klicken Sie im Navigationsmenü der Benutzeroberfläche von „ Instana “ auf „Einstellungen “.

  2. Klicken Sie auf der Registerkarte „Globale Einstellungen “ im Abschnitt „Ereignisse und Benachrichtigungen “ auf „Benachrichtigungskanäle “.

  3. Klicken Sie auf „Benachrichtigungskanal hinzufügen “.

  4. Wählen Sie aus der Liste eine App für „ Slack “ aus.

  5. Geben Sie einen Namen für den Benachrichtigungskanal der Anwendung „ Slack “ ein.

    Abbildung 1. App für den „ Slack “-Benachrichtigungskanal
    App für den „ Slack “-Benachrichtigungskanal

    Emojis anzeigen : Aktivieren Sie diese Option, um Emoji-Zeichenfolgen aus Instana (zum Beispiel ) in visuelle :warning:Emojis umzuwandeln, wenn sie auf Slack angezeigt werden. Wenn diese Option deaktiviert ist, werden die Zeichenfolgen als Klartext angezeigt.

  6. Klicken Sie in „ Slack “ auf „Authentifizieren“.

    Wenn Sie in „ Slack “ auf „Authentifizieren“ klicken, wird ein Standard-Autorisierungsablauf für Slack, OAuth und 2.0 gestartet. Ihr Browser leitet Sie zu dem „ Slack “-Arbeitsbereich weiter, in dem Sie derzeit angemeldet sind, oder zu Ihrem Standard-Arbeitsbereich. Slack bestimmt das Weiterleitungsziel anhand Ihrer aktiven Browsersitzung und nicht anhand von Instana. Wenn Sie bei mehreren Arbeitsbereichen angemeldet sind, werden Sie von „ Slack “ möglicherweise aufgefordert, einen auszuwählen.

  7. Wählen Sie einen „ Slack “-Arbeitsbereich aus und erteilen Sie der Anwendung die erforderlichen Berechtigungen.

    Abbildung 2. Slack App- OAuth
    Slack App- OAuth
Hinweis: Wenn Sie einen privaten Kanal unter Slack auswählen, installieren Sie zunächst die App „ IBM “ unter Instana auf Workspace-Ebene, indem Sie einen beliebigen öffentlichen Kanal unter Slack verwenden. Führen Sie anschließend die Schritte unter „Verwendung der Anwendung ‚ Slack ‘ mit einem privaten Kanal “ aus.
Abbildung 3. Kanalauswahl
Kanalauswahl

Sie finden Ihren Benachrichtigungskanal im Bereich „Benachrichtigungskanäle“ der Benutzeroberfläche von „ Instana “.

Hinweis: Sie müssen den Benachrichtigungskanal unter Slack erneut authentifizieren, wenn Sie einen Benachrichtigungskanal nach dessen Erstellung bearbeiten.

Slack Genehmigung durch den Workspace-Administrator

Falls in Ihrem „ Slack “-Arbeitsbereich die Installation von Apps von Drittanbietern eingeschränkt ist, muss ein Arbeitsbereichsadministrator die App „ IBM “ ( Instana ) vor der Installation genehmigen.

Je nach der Konfiguration des „ Slack “-Arbeitsbereichs in Ihrer Organisation muss ein Administrator des „ Slack “-Arbeitsbereichs möglicherweise die App „ IBM “ unter Instana genehmigen, bevor sie installiert werden kann. Wenn in Ihrer Arbeitsumgebung die Installation von Apps von Drittanbietern eingeschränkt ist, wird auf dem Einwilligungsbildschirm von „ OAuth “ anstelle von „Zulassen“ die Option „Installationsanfrage“ angezeigt. Führen Sie in diesem Fall die folgenden Schritte aus:

  1. Klicken Sie auf „Installieren anfordern“, um eine Genehmigungsanfrage an den Administrator Ihres „ Slack “-Arbeitsbereichs zu senden.
  2. Der Administrator des Arbeitsbereichs „ Slack “ erhält die Anfrage und kann sie unter „ Slack -Verwaltung > Apps verwalten > Genehmigungsanfragen für Apps“ prüfen und genehmigen.
  3. Nachdem der Administrator die Anfrage genehmigt hat, kehren Sie zur Benutzeroberfläche von „ Instana “ zurück und schließen Sie den Authentifizierungsvorgang ab. Möglicherweise müssen Sie die Schritte zur Erstellung des Benachrichtigungskanals von vorne beginnen, da die ursprüngliche Sitzung während des Genehmigungsvorgangs möglicherweise abgelaufen ist.
Hinweis: Diese Genehmigungsabläufe werden vom Slack -Administrationsteam Ihrer Organisation verwaltet und können je nach den Sicherheitsrichtlinien und -protokollen Ihrer Organisation variieren.
  1. Geben Sie nach der Authentifizierung den Kanalnamen „ Slack “ ein, um Benachrichtigungen zu erhalten.
  2. Klicken Sie auf Speichern.
    Abbildung 4. Kanalauswahl

    Sie finden Ihren Benachrichtigungskanal im Bereich „Benachrichtigungskanäle“ der Benutzeroberfläche von „ Instana “.

Hinweis: Wenn Sie einen privaten Kanal „ Slack “ auswählen, müssen Sie zunächst die App „ IBM “ Instana auf Workspace-Ebene über einen öffentlichen Kanal „ Slack “ installieren. Führen Sie anschließend die Schritte unter „Verwendung der Anwendung ‚ Slack ‘ mit einem privaten Kanal “ aus.
Hinweis: Sie müssen den Benachrichtigungskanal unter Slack erneut authentifizieren, wenn Sie einen Benachrichtigungskanal nach dessen Erstellung bearbeiten.

Erforderliche Geltungsbereiche

Die App für „ Slack “ benötigt die folgenden Bereiche von „ OAuth “:

  • channels:history
  • channels:read
  • chat:write
  • groups:history
  • groups:read
  • users:read

Hinzufügen der App „ IBM “ ( Instana ) zu den Kanalintegrationen von „ Slack “

Hinweis: Sie müssen diese Integration sowohl für öffentliche als auch für private Kanäle in „ Slack “ durchführen.
  1. Klicken Sie im Gesprächsbereich auf den Kanalnamen. Es erscheint ein Dialogfeld mit den Kanalinformationen.

  2. Wählen Sie im Fenster „Kanal-Details“ die Registerkarte „Integrationen“ aus.

  3. Klicken Sie auf der Registerkarte „Integrationen “ auf „Apps hinzufügen “.

  4. Suchen Sie nach „ IBM “ und wählen Sie „ Instana “ aus.

    Abbildung 5. App für „ Slack “ hinzufügen
    App für „ Slack “ hinzufügen

Verwendung der Anwendung „ Slack “ mit einem privaten Kanal

Führen Sie die folgenden Schritte aus, um die App „ IBM “ Instana in einem privaten Kanal unter Slack zu verwenden:

  1. Bevor Sie beginnen, installieren Sie die App „ IBM “ Instana in einem öffentlichen Kanal Slack.
  2. Öffne in „ Slack “ deinen privaten Kanal und klicke im Gesprächsbereich auf dessen Namen.
  3. Wählen Sie im Dialogfeld „Kanal-Details“ die Registerkarte **Integrationen** aus.
  4. Klicken Sie auf „Apps hinzufügen “.
  5. Suchen Sie nach „ IBM “ und wählen Sie „ Instana “ aus. Weitere Informationen finden Sie unter „Hinzufügen der App ‚ IBM ‘ Instana zu den Kanalintegrationen von Slack “.
  6. Nachdem Sie die App hinzugefügt haben, erstellen Sie Ihren Benachrichtigungskanal „App for Slack “ in der „ Instana “, indem Sie die Schritte befolgen, die unter „Erstellen eines Benachrichtigungskanals ‚App for Slack ‘“ beschrieben sind.

Konfigurieren Sie Benachrichtigungen in der Benutzeroberfläche von „ Instana “

Sie können Ihre bestehenden oder neuen Benachrichtigungen über die App für den Benachrichtigungskanal „ Slack “ konfigurieren. Weitere Informationen finden Sie unter „Konfigurieren und Verwalten von Benachrichtigungen “. Alle Alarmereignisse werden automatisch in dem von Ihnen ausgewählten Kanal „ Slack “ angezeigt.

Synchronisierung der Nachrichten unter Slack und Instana

Nachrichten werden zwischen Instana und Slack synchronisiert. Nachrichten, die innerhalb eines Vorfalls in einem „ Slack “-Thread hinzugefügt werden, werden in der Benutzeroberfläche von „ Instana “ im Abschnitt „Zusammenfassung und Notizen mit KI“ angezeigt. Ebenso werden Notizen, die im Bereich „Zusammenfassung“ und im Abschnitt „Notizen mit KI“ der Benutzeroberfläche von „ Instana “ hinzugefügt werden, im zugehörigen Vorfall-Thread unter „ Slack “ angezeigt.

Abbildung 6. Instana Anmerkungen
Instana Anmerkungen
Abbildung 7. Slack Thema
Slack Thema

Darüber hinaus werden die Zusammenfassung des Vorfalls und die Zusammenfassung der Notizen, die im Abschnitt „Zusammenfassung und Notizen mit KI“ der Benutzeroberfläche von „ Instana “ erstellt werden, auch im zugehörigen Vorfallsthread auf Slack angezeigt.

Abbildung 8. Instana Zusammenfassung des Vorfalls
Instana Zusammenfassung des Vorfalls
Abbildung 9. Slack Zusammenfassung des Threads
Slack Zusammenfassung des Threads
Hinweis: Derzeit gilt diese Funktion zur Nachrichtensynchronisierung zwischen Slack und Instana nur für Vorfälle auf Instana.

Abschlussveranstaltung von „ Slack “

Um einen Vorfall, ein Problem oder eine Änderung in der Anwendung „ Slack “ abzuschließen, führen Sie die folgenden Schritte aus.

  1. Wählen Sie in „ Slack “ einen offenen Vorfall, ein offenes Problem oder eine offene Änderung aus.

  2. Klicken Sie je nach Ereignistyp auf „Vorfall schließen “, „Problem schließen “ oder „Überwachungsprobleme schließen “.
    Abbildung 10. Eine Veranstaltung beenden
    Eine Veranstaltung beenden
  3. Geben Sie einen Grund für die Schließung ein und klicken Sie dann auf „OK “.
    Abbildung 11. Abschlussbestätigung
    Abschlussbestätigung
  4. Der Status des Ereignisses in der Benutzeroberfläche von „ Instana “ muss auf „Manuell geschlossen“ gesetzt werden.

    Abbildung 12. Veranstaltung ist beendet
    Veranstaltung ist beendet
  5. In „ Slack “ muss der Status des Ereignisses auf „Geschlossen“ gesetzt werden; daraufhin sendet die App sowohl bei manuell als auch bei automatisch geschlossenen Ereignissen eine Antwort zum Abschluss des Threads unter der Ereignismeldung.

    Abbildung 13. Manuell geschlossene Veranstaltung
    Manuell geschlossene Veranstaltung
    Abbildung 14. Automatisch geschlossenes Ereignis
    Automatisch geschlossenes Ereignis

Fehlerbehebung

Häufige Probleme und Lösungen bei der Integration von IBM Instana mit Slack.

OAuth Die Weiterleitung führt zu einem unerwarteten Arbeitsbereich unter Slack

Wenn Sie in „ Slack “ auf „Authentifizieren“ klicken, leitet Slack Sie zu dem Arbeitsbereich weiter, der Ihrer aktuellen Browsersitzung zugeordnet ist. Falls Sie zum falschen Arbeitsbereich weitergeleitet werden, führen Sie bitte die folgenden Schritte aus:

  1. Melden Sie sich in Ihrem Browser von diesem Arbeitsbereich ab.
  2. Melden Sie sich im gewünschten Arbeitsbereich an.
  3. Versuchen Sie die Authentifizierung über die Benutzeroberfläche von „ Instana “ erneut.

Slack Es ist eine Genehmigung durch den Administrator erforderlich

Wenn der „ Slack “-Arbeitsbereich Ihrer Organisation die Installation von Apps von Drittanbietern einschränkt, wird während des Vorgangs „ OAuth “ anstelle von „Zulassen“ die Schaltfläche „Installation anfordern“ angezeigt. Führen Sie die folgenden Schritte aus:

  1. Übergeben Sie die Anforderung.
  2. Sprechen Sie sich mit Ihrem „ Slack “-Workspace-Administrator ab, um die Anfrage zu genehmigen.

Weitere Informationen finden Sie unter „Genehmigung durch den Workspace-Administrator “ auf Slack.

IBM Instana Die App ist im „ Slack “-Marktplatz nicht zu finden

Die App „ IBM “ ( Instana ) für „ Slack “ durchläuft derzeit die Zertifizierung für den „ Slack Marketplace“ und ist noch nicht öffentlich verfügbar. Die App wird über den Authentifizierungsablauf der Benutzeroberfläche von „ Instana “ installiert, nicht über den „ Slack “-Marktplatz.

Befolgen Sie zur Installation der App die Schritte unter „Erstellen einer App für den Benachrichtigungskanal ‚ Slack ‘“.

Datenschutzrichtlinie

In der Datenschutzerklärung werden die Arten der erhobenen Daten und deren Verwendungszwecke beschrieben.

Datenerfassungspraktiken

Wenn Sie die App „ IBM “ ( Instana ) für „ Slack “ installieren und nutzen, werden folgende Arten von Informationen erfasst:

  • Slack Informationen zum Arbeitsbereich : Teamname, Team-ID und Kanalangaben, um das Posten von Benachrichtigungen und Interaktionen zu ermöglichen.
  • Benutzerinformationen : Slack -Benutzernamen, um Aktionen zu generieren und Notizen zu Interaktionen zu führen.
  • Nachrichteninhalt : Begrenzte Inhalte von Nachrichten oder Ereignissen, mit denen Sie explizit interagieren oder für die Sie der Anwendung den Zugriff gestatten, um Benachrichtigungen zu senden oder interaktive Funktionen bereitzustellen.

Weitere Informationen finden Sie in den Richtlinien zur Datenspeicherung von IBM.

Hinweis: Die Aufbewahrung von Daten im Zusammenhang mit der Verwaltung und Speicherung von Daten Dritter erfolgt gemäß den geltenden Richtlinien von IBM.

Verwendung Ihrer Daten

Die erhobenen Daten werden verwendet, um:

  • Integrationsfunktionen bereitstellen, pflegen und verbessern.
  • Senden Sie relevante Benachrichtigungen und Updates gemäß der Konfiguration an Ihre „ Slack “-Kanäle.
  • Auf Anfrage bieten wir Unterstützung bei der Fehlerbehebung, beim Debugging und technische Hilfe an.
  • Beachten Sie die geltenden Gesetze und Vorschriften.

Weitere Informationen finden Sie unter „ IBM -Nutzungsbedingungen und Datenschutz “.

Antrag auf Löschung von Daten

Sie können die Löschung Ihrer personenbezogenen Daten beantragen, die über die App „ IBM “ unter Instana für Slack erfasst wurden.

Um die Löschung Ihrer Daten zu beantragen, führen Sie bitte die folgenden Schritte aus:

  1. Go an den Support von IBM Instana.
  2. Reichen Sie ein Support-Ticket ein, um die Löschung Ihrer personenbezogenen Daten zu beantragen.
  3. Geben Sie bitte alle relevanten Arbeitsbereichs-IDs an (z. B. Slack, Team-ID oder Kanal-ID), damit IBM Ihre Anfrage bearbeiten kann.

IBM prüft und bearbeitet Anträge auf Datenlöschung gemäß seinen Datenschutz-, Privatsphäre- und Aufbewahrungsrichtlinien.