Konfigurieren von Slack-Benachrichtigungen

AI/BI-Dashboards unterstützen das Senden geplanter Momentaufnahmen an Slack-Kanäle. Auf diese Weise können Teams Dashboardupdates direkt in ihrem Slack-Arbeitsbereich empfangen. Auf dieser Seite wird erläutert, wie Sie eine Slack-App erstellen und einen Slack-Kanal als Benachrichtigungsziel konfigurieren. Dashboard-Editoren können dieses Benachrichtigungsziel dann als Abonnent für geplante Dashboards hinzufügen. Informationen zum Hinzufügen eines Slack-Kanals als Abonnent finden Sie unter Abonnieren eines Slack- oder Microsoft Teams-Kanals.

Slack-Abonnements liefern Dashboardmomentaufnahmen, die Folgendes umfassen:

• Eine PNG-Bildmomentaufnahme des Dashboards, das direkt im Kanal sichtbar ist
• Ein direkter Link zum Öffnen des Dashboards in Azure Databricks
• Eine PDF-Momentaufnahmeanlage im Nachrichtenthread

Anforderungen

Sie müssen über die folgenden Berechtigungen verfügen:

• Sie müssen ein Azure Databricks-Arbeitsbereichsadministrator sein, um Benachrichtigungsziele zu konfigurieren.
• Sie müssen über die entsprechenden Berechtigungen zum Erstellen und Installieren von Apps in Ihrem Slack-Arbeitsbereich verfügen.

Während des Setupvorgangs sammeln Sie Authentifizierungsanmeldeinformationen von Slack, um das Azure Databricks-Benachrichtigungsziel zu konfigurieren.

Nachdem Sie das Benachrichtigungsziel konfiguriert haben, kann jeder Benutzer mit CAN EDIT-Berechtigungen auf einem Dashboard das Slack-Ziel als Abonnent hinzufügen, um zeitpläne zu verwalten.

Schritt 1: Erstellen und Konfigurieren einer Slack-App

Erstellen Sie eine Slack-App für Ihren Arbeitsbereich, und konfigurieren Sie die erforderlichen Berechtigungen.

Erstellen der Slack-App

1. Wechseln Sie in der Slack-API-Dokumentation zu "Ihre Apps ". Möglicherweise werden Sie aufgefordert, sich bei Ihrem Slack-Arbeitsbereich anzumelden.
2. Klicken Sie auf "App erstellen".
3. Klicken Sie auf 'Von einem Manifest' oder 'Von Grund auf', je nachdem, ob Sie über eine Manifestdatei verfügen, um die grundlegenden Informationen Ihrer App hinzuzufügen, oder ob Sie diese mithilfe der Konfigurations-UI von Slack erstellen möchten. Anweisungen zum Erstellen aus einem Manifest finden Sie in der Slack-Dokumentation zum Konfigurieren von Apps mit App-Manifesten .

Nachdem Sie die App erstellt haben, wird die Seite mit den Slack-App-Einstellungen automatisch geöffnet.

Hinzufügen erforderlicher OAuth-Bereiche

1. Klicken Sie in der Randleiste unter "Features" auf "OAuth" und "Berechtigungen".
2. Scrollen Sie nach unten zu Bereichen.
3. Klicken Sie unter Bot-Tokenbereiche auf "OAuth-Bereich hinzufügen".
4. Fügen Sie die folgenden Bereiche hinzu:
   • incoming-webhook
   • files:write
   • files:read
   • chat:write

Installieren der App in Ihrem Arbeitsbereich

1. Klicken Sie in der Randleiste der Slack-App-Einstellungen unter "Einstellungen" auf "App installieren".
2. Klicken Sie auf "Installieren " oder "Installieren anfordern".
3. Wählen Sie einen Zielkanal in Ihrem Arbeitsbereich aus.
4. Klicken Sie auf "Zulassen ", um die Installation abzuschließen.

Überprüfen, ob die App zu Ihrem Zielkanal hinzugefügt wurde

1. Öffnen Sie im Slack-Arbeitsbereich den Zielkanal. Klicken Sie oben im Fenster auf den Kanalnamen.

2. Klicken Sie auf die Registerkarte "Integrationen ".

   

3. Vergewissern Sie sich unter "Apps", dass der soeben erstellte Bot angezeigt wird. Wenn sie nicht angezeigt wird, klicken Sie auf "Apps hinzufügen ", und fügen Sie sie hinzu.

Authentifizierungsdaten abrufen

Sie benötigen die folgenden Informationen aus der Slack-App, um das Azure Databricks-Benachrichtigungsziel zu konfigurieren:

1. OAuth-Token des Bot-Benutzers:
   • Navigieren Sie in den Slack-App-Einstellungen zu OAuth & Permissions .
   • Kopieren Sie das OAuth-Token des Bot-Benutzers.
2. Webhook-URL:
   • Navigieren Sie zu Incoming Webhooks in den Slack-App-Einstellungen.
   • Kopieren Sie die Webhook-URL für Ihren Zielkanal.

Slack-Kanal-ID abrufen

1. Navigieren Sie in Ihrem Slack-Arbeitsbereich zum Zielkanal.
2. Klicken Sie auf den Kanalnamen, um Kanaldetails zu öffnen.
3. Kopieren Sie die Kanal-ID aus den Kanaldetails.

Schritt 2: Konfigurieren des Benachrichtigungsziels in Azure Databricks

Erstellen Sie ein Benachrichtigungsziel in Ihrem Azure Databricks-Arbeitsbereich, der auf Ihren Slack-Kanal verweist.

1. Melden Sie sich bei Ihrem Azure Databricks-Arbeitsbereich an.
2. Klicken Sie in der oberen rechten Ecke des Arbeitsbereichs auf Ihren Benutzernamen.
3. Wählen Sie "Einstellungen" aus der Dropdownliste aus.
4. Klicken Sie im Abschnitt Arbeitsbereichsadministrator auf die Registerkarte Benachrichtigungen.
5. Klicken Sie im Abschnitt "Benachrichtigungsziele" auf "Verwalten".
6. Klicken Sie auf "Ziel hinzufügen".
7. Wählen Sie Slack aus der Dropdownliste für den Zieltyp aus.
8. Geben Sie die folgenden Informationen ein:
   • Zielname: Ein beschreibender Name für dieses Slack-Ziel
   • Slack-Webhook-URL: Die Webhook-URL aus Ihrer Slack-App
   • OAuth-Token: Das OAuth-Token des Bot-Benutzers aus Ihrer Slack-App
   • Slack-Kanal-ID: Die Kanal-ID aus Ihrem Slack-Arbeitsbereich
9. Klicken Sie auf "Erstellen".

Benutzer können jetzt das Slack-Benachrichtigungsziel als Abonnent zu Dashboard-Zeitplänen hinzufügen.

Anweisungen zum Abonnieren von Slack-Kanälen für Dashboardzeitpläne finden Sie unter Abonnieren eines Slack- oder Microsoft Teams-Kanals.

Problembehandlung

Gehen Sie wie folgt vor, um häufige Fehler mit Slack-Benachrichtigungen zu beheben.

Fehlender PDF-Anhang

Wenn die Slack-Benachrichtigung ohne PDF-Anlage angezeigt wird, überprüfen Sie Folgendes:

• Das OAuth-Token ist im Benachrichtigungsziel ordnungsgemäß konfiguriert.
• Die Kanal-ID entspricht dem Zielkanal.
• Die Slack-App verfügt über den erforderlichen files:write Bereich.

Die Benachrichtigung wird nicht angezeigt.

Wenn Benachrichtigungen nicht in Ihrem Slack-Kanal angezeigt werden:

• Überprüfen, ob die Webhook-URL korrekt ist und dem Zielkanal entspricht
• Überprüfen, ob die Slack-App im Arbeitsbereich installiert ist
• Stellen Sie sicher, dass der Bot dem Zielkanal hinzugefügt wurde.
• Bestätigen, dass der Zeitplan aktiv ist und nicht pausiert ist

Nächste Schritte

• Abonnieren Sie Slack-Kanäle für Dashboardzeitpläne. Siehe Abonnieren eines Slack- oder Microsoft Teams-Kanals
• Konfigurieren von E-Mail-Benachrichtigungszielen. Siehe Verwalten von Benachrichtigungszielen