Gestire le destinazioni di notifica

Questa pagina illustra come creare e configurare le destinazioni di notifica per l'area di lavoro.

Le notifiche di sistema sono messaggi che indicano quando il flusso di lavoro riscontra un evento di esecuzione (avvio, esito positivo e negativo). Per impostazione predefinita, le notifiche vengono inviate agli indirizzi email degli utenti, ma gli amministratori possono configurare destinazioni alternative tramite webhook o l'app Databricks Genie per Slack e Microsoft Teams (Beta). In questo modo è possibile creare integrazioni guidate dagli eventi con Azure Databricks.

Gli amministratori possono anche configurare le destinazioni di notifica per ricevere le richieste di accesso dagli utenti dell'area di lavoro, ad esempio le richieste di privilegi per gli oggetti del catalogo Unity.

Per gestire le destinazioni di notifica, è necessario essere un amministratore dell'area di lavoro Azure Databricks. Dopo aver configurato una destinazione, questa viene resa disponibile a tutti gli utenti.

Requisiti di rete

Per le destinazioni basate su webhook, l'endpoint ricevente deve soddisfare i seguenti requisiti:

• Azure Databricks applica l'uso di HTTPS per la sicurezza. La destinazione di notifica deve usare certificati SSL (Secure Sockets Layer) firmati da un'autorità di certificazione attendibile.
• La destinazione di notifica deve aggiungere sia il piano di controllo dell'area di lavoro che gli indirizzi IP in uscita del piano dati all'elenco elementi consentiti:

  • Per gli indirizzi IP dell'app Web del piano di controllo, vedere indirizzi IP e domini per i servizi e le risorse di Azure Databricks.

  • Per gli indirizzi IP in uscita del piano dati, vedere il ip-ranges.json file che Azure Databricks pubblica. Trova nel file la regione del piano dati della tua area di lavoro e sblocca gli indirizzi IP in uscita corrispondenti nel tuo stack di rete.

    Azure Databricks possono aggiornare gli indirizzi IP in uscita ogni 30 giorni. Gli indirizzi IP aggiornati diventano attivi anche solo 60 giorni dopo la pubblicazione, quindi esaminare regolarmente il file e aggiornare la lista di autorizzazione prima della chiusura della finestra di attivazione.

    Per tenere traccia delle modifiche tra le versioni, salvare le versioni successive del file JSON e confrontare il timestampSeconds valore. Filtra le voci in cui:

    • Il service campo è Databricks
    • Il platform campo è azure
    • Il type campo è outbound

Creare una nuova destinazione di notifica

Configurare una nuova destinazione di notifica

1. Fare clic sul nome utente nella barra superiore dell'area di lavoro e selezionare Impostazioni dall'elenco a discesa.
2. Nella sezione Amministratore dell'area di lavoro fare clic sulla scheda Notifiche.
3. Fare clic sul pulsante Gestisci.
4. Fare clic su Aggiungi destinazione.
5. Selezionare un tipo di destinazione. Al momento, sono supportate le destinazioni seguenti:
   • E-mail
   • Slack
   • Webhook, con autenticazione OAuth opzionale (Beta)
   • Microsoft Teams
   • PagerDuty
6. Configurare la destinazione in base al tipo.
7. Cliccare su Crea.

Usare credenziali diverse per ogni destinazione

La configurazione di una destinazione viene archiviata in modo sicuro crittografata nell'area di lavoro Azure Databricks. Per le destinazioni che richiedono di fornire un URL o credenziali, Azure Databricks consiglia di utilizzare credenziali diverse per ogni destinazione configurata. Questo limita l'impatto se un endpoint di terze parti viene compromesso. Tra questi:

• Slack che usa un webhook: l'URL a cui viene inviata la notifica.
• Microsoft Teams che utilizza un webhook: l'URL a cui viene inviata la notifica.
• PagerDuty: chiave di integrazione usata per instradare in modo univoco le notifiche a un servizio PagerDuty.
• Webhook: un nome utente e una password per l'autenticazione HTTP Basic, oppure un ID client e un client secret per l'autenticazione OAuth (Beta).

L'uso di segreti diversi per ogni destinazione configurata consente di revocare singolarmente l'accesso alle singole destinazioni di notifica senza influire sul funzionamento di tutte le altre destinazioni nell'area di lavoro Azure Databricks.

Autenticazione OAuth per destinazioni webhook

Usa le credenziali client OAuth 2.0 per inviare notifiche a un endpoint che richiede un token di accesso. Azure Databricks ottiene il token dal tuo fornitore di identità e lo utilizza per autenticare la richiesta di notifica.

Il tuo fornitore di identità deve supportare la concessione delle credenziali del cliente. Sia l'endpoint ricevente che quello del token devono utilizzare HTTPS.

Per creare una destinazione di webhook OAuth:

1. Nelle Impostazioni>Notifiche, clicca su Gestisci, poi +Aggiungi destinazione.
2. Inserisci un nome e seleziona Webhook per Tipo.
3. Per la modalità Autenticazione, seleziona OAuth.
4. Immettere i valori seguenti:
   • URL: L'endpoint che riceve le notifiche.
   • ID Cliente e Segreto del Cliente: Le credenziali rilasciate dal tuo fornitore di identità.
   • URL endpoint del token: L'endpoint da cui Azure Databricks ottiene un token di accesso.
   • Ambiti e Destinatario: inserisci questi valori opzionali se richiesti dal tuo provider di identità. Separare più ambiti con virgole.
5. Cliccare su Crea.

L'ID client, il client secret e l'URL dell'endpoint del token sono richiesti insieme. OAuth non può essere combinato con l'autenticazione HTTP Basic.

Per verificare la configurazione, apri il menu a tre punti della destinazione e clicca su Test. Azure Databricks ottiene un token di accesso e invia una notifica di esempio. Se il test fallisce, controlla le credenziali, gli ambiti, il pubblico, i permessi del ricevitore e l'accesso alla rete a entrambi gli endpoint.

Destinazione Slack

Per impostare una destinazione Slack basata su webhook, segui le istruzioni in Incoming webhook per Slack. Incollare l'URL generato nella destinazione di notifica Azure Databricks. Per utilizzare invece l'app Databricks Genie, consulta le destinazioni app Slack e Microsoft Teams Genie.

Destinazioni delle app Slack e Microsoft Teams Genie

Usa l'app Databricks Genie per collegare il tuo workspace Slack o il tenant Microsoft Teams al tuo workspace Azure Databricks. Poi seleziona un canale disponibile come destinazione di notifica.

Puoi utilizzare le destinazioni dell'app Genie con le seguenti funzionalità:

• Avvisi SQL: Slack e Microsoft Teams.
• Richieste di accesso al catalogo Unity: Slack e Microsoft Teams.
• Notifiche degli endpoint per il model serving: Slack.

Crea una destinazione per l'app Genie

Prima di creare una destinazione per l'app Genie, devi installare l'app Databricks Genie per Slack o Microsoft Teams, collegarla al tuo workspace Azure Databricks e aggiungerla al canale che riceve le notifiche. Per dettagli su installazione dell'app e sui passaggi di connessione, vedi Slack o Microsoft Teams.

Per creare una destinazione per l'app Genie:

1. Nelle Impostazioni>Notifiche, clicca su Gestisci, poi +Aggiungi destinazione.

2. Per Type, seleziona Slack o Microsoft Teams, poi seleziona Using Databricks App.

3. Inserisci un nome per la destinazione.

4. Seleziona lo spazio di lavoro o il tenant e il canale:

   • Per Slack, seleziona l'Area di lavoro e il Canale Slack.
   • Per Microsoft Teams, seleziona il Tenant e il Canale. Il selezionatore di inquilino identifica ogni inquilino con gli ultimi sei caratteri del suo ID inquilino.

   Se non sono connessi spazi di lavoro Slack o tenant Microsoft Teams, clicca su Collega un workspace Slack o Collega un tenant Teams, rispettivamente, e completa la configurazione dell'app Genie. Torna al modulo di destinazione e clicca su Aggiorna. Se hai appena aggiunto l'app Genie a un canale, clicca su Ricarica canali per aggiornare la lista dei canali.

5. Cliccare su Crea.

Destinazione PagerDuty

Per impostare una destinazione PagerDuty:

1. In PagerDuty, aggiungi un'integrazione al tuo servizio e seleziona il tipo di integrazione Events API V2 .
2. Copia la chiave di integrazione che PagerDuty genera per l'integrazione.
3. In Azure Databricks, incolla la chiave di integrazione nella destinazione di notifica PagerDuty.

Aggiungere un webhook a un job

Dopo aver configurato le destinazioni, è possibile accedervi nelle impostazioni delle notifiche di un processo. Per altre informazioni, vedere Aggiungere notifiche in un processo.

Ogni processo supporta fino a tre destinazioni di sistema per ogni tipo di evento. Quando si configurano le notifiche dei processi, gli indirizzi di posta elettronica devono essere immessi manualmente.

Limiti

Le destinazioni di notifica presentano attualmente le limitazioni seguenti:

• Le destinazioni di notifica tramite posta elettronica hanno un limite di 1.300 caratteri sulla lunghezza dell'indirizzo del destinatario.
• Per i corpi di notifica personalizzati, destinazioni non email come Slack e Microsoft Teams non supportano la formattazione HTML. Alcune destinazioni di notifica supportano markdown.
• Per i lavori, le destinazioni di posta elettronica devono essere impostate manualmente nelle impostazioni del lavoro.