Delen via


Slack-meldingen configureren

AI/BI-dashboards bieden ondersteuning voor het verzenden van geplande momentopnamen naar Slack-kanalen. Hierdoor kunnen teams dashboardupdates rechtstreeks in hun Slack-werkruimte ontvangen. Op deze pagina wordt uitgelegd hoe u een Slack-app maakt en een Slack-kanaal configureert als een meldingsbestemming. Dashboardeditors kunnen deze meldingsbestemming vervolgens als abonnee toevoegen aan geplande dashboards. Zie Een Slack- of Microsoft Teams-kanaal abonneren voor informatie over het toevoegen van een Slack-kanaal als abonnee.

Slack-abonnementen bieden dashboardoverzichten met:

  • Een PNG-snapshot van het dashboard dat direct in het kanaal zichtbaar is
  • Een directe koppeling om het dashboard te openen in Azure Databricks
  • Een PDF-momentopnamebijlage in de berichtenthread

Voorbeeld van een Slack-melding met een momentopname van een dashboard

Requirements

U moet over de volgende machtigingen beschikken:

  • U moet een Azure Databricks-werkruimtebeheerder zijn om meldingsbestemmingen te configureren.
  • U moet over de juiste machtigingen beschikken om apps te maken en te installeren in uw Slack-werkruimte.

Tijdens het installatieproces verzamelt u authenticatiegegevens van Slack om de Azure Databricks-meldingsbestemming te configureren.

Nadat u de meldingsbestemming hebt geconfigureerd, kan elke gebruiker met CAN EDIT-machtigingen op een dashboard de Slack-bestemming als abonnee toevoegen aan de planningen die ze beheren.

Stap 1: Een Slack-app maken en configureren

Maak een Slack-app voor uw werkruimte en configureer de benodigde machtigingen.

De Slack-app maken

  1. Ga naar Uw apps in de Slack API-documentatie. U wordt mogelijk gevraagd u aan te melden bij uw Slack-werkruimte.
  2. Klik op Een app maken.
  3. Klik op Van een manifest of Vanaf nul, afhankelijk van of u een manifestbestand hebt om de basisinformatie van uw app toe te voegen, of als u het wilt maken met behulp van de configuratie-UI van Slack. Zie de documentatie van Slack over het configureren van apps met app-manifesten voor instructies over het maken van een manifest.

Nadat u de app hebt gemaakt, wordt de pagina Slack-app-instellingen automatisch geopend.

Vereiste OAuth-bereiken toevoegen

  1. Klik in de zijbalk onder Functies op OAuth en machtigingen.
  2. Schuif omlaag naar Bereiken.
  3. Klik onder BotTokenbereiken op Een OAuth-bereik toevoegen.
  4. Voeg de volgende reikwijdtes toe:
    • incoming-webhook
    • files:write
    • files:read
    • chat:write

De app installeren in uw werkruimte

  1. Klik in de zijbalk van de Slack-app-instellingen onder Instellingen op App installeren.
  2. Klik op Installeren of Aanvragen om te installeren.
  3. Selecteer een doelkanaal in uw werkruimte.
  4. Klik op Toestaan om de installatie te voltooien.

Controleer of de app is toegevoegd aan uw doelkanaal

  1. Open het doelkanaal in uw Slack-werkruimte. Klik op de kanaalnaam boven aan het venster.

  2. Klik op het tabblad Integraties .

    Kanaaldetails in een Slack-werkruimte.

  3. Controleer onder Apps of u de bot ziet die u zojuist hebt gemaakt. Als u deze niet ziet, klikt u op Apps toevoegen en voegt u deze toe.

Verificatiereferenties ophalen

U hebt de volgende informatie van de Slack-app nodig om de Azure Databricks-meldingsbestemming te configureren:

  1. OAuth-token voor botgebruiker:
    • Navigeer naar OAuth & Machtigingen in de Slack-app-instellingen.
    • Kopieer het OAuth-token van de botgebruiker.
  2. Webhook-URL:
    • Navigeer naar Incoming Webhooks in de Slack-app-instellingen.
    • Kopieer de Webhook-URL voor uw doelkanaal.

De Slack-kanaal-id ophalen

  1. Navigeer in uw Slack-werkruimte naar het doelkanaal.
  2. Klik op de naam van het kanaal om kanaaldetails te openen.
  3. Kopieer de kanaal-id uit de kanaaldetails.

Stap 2: De meldingsbestemming configureren in Azure Databricks

Maak een meldingsbestemming in uw Azure Databricks-werkruimte die verwijst naar uw Slack-kanaal.

  1. Meld u aan bij uw Azure Databricks-werkruimte.
  2. Klik op uw gebruikersnaam in de rechterbovenhoek van de werkruimte.
  3. Selecteer Instellingen in de vervolgkeuzelijst.
  4. Klik in de sectie Werkruimtebeheerder op het tabblad Meldingen .
  5. Klik op Beheren in de sectie Meldingsbestemmingen .
  6. Klik op Bestemming toevoegen.
  7. Selecteer Slack in de vervolgkeuzelijst van het bestemmingstype.
  8. Voer de volgende gegevens in:
    • Doelnaam: een beschrijvende naam voor deze Slack-bestemming
    • Slack Webhook-URL: de webhook-URL van uw Slack-app
    • OAuth-token: het OAuth-token van de botgebruiker van uw Slack-app
    • Slack-kanaal-id: de kanaal-id van uw Slack-werkruimte
  9. Klik op Create.

Gebruikers kunnen deze Slack-notificatiebestemming nu als abonnee toevoegen aan dashboardschema's.

Zie Een Slack- of Microsoft Teams-kanaal abonneren voor instructies over het abonneren op Slack-kanalen voor dashboardschema's.

Probleemoplossingsproces

Gebruik het volgende om veelvoorkomende fouten met Slack-meldingen op te lossen.

Ontbrekende PDF-bijlage

Als de Slack-melding wordt weergegeven zonder een PDF-bijlage, controleert u of:

  • Het OAuth-token is correct geconfigureerd in de meldingsbestemming
  • De kanaal-id komt overeen met het doelkanaal
  • De Slack-app heeft het vereiste files:write bereik

Melding wordt niet weergegeven

Als meldingen niet worden weergegeven in uw Slack-kanaal:

  • Controleer of de URL van de webhook juist is en overeenkomt met het doelkanaal
  • Controleer of de Slack-app is geïnstalleerd in de werkruimte
  • Zorg ervoor dat de bot is toegevoegd aan het doelkanaal
  • Controleer of de planning actief is en niet is onderbroken

Volgende stappen