Gerenciar destinos de notificação

Esta página ensina como criar e configurar destinos de notificação para seu workspace.

Notificações do sistema são mensagens que informam quando o fluxo de trabalho experimenta um evento de execução (início, êxito e falha). Por padrão, as notificações são enviadas para endereços de e-mail dos usuários, mas os administradores podem configurar destinos alternativos de notificação usando webhooks ou o aplicativo Databricks Genie para Slack e Microsoft Teams (Beta). Isso permite que você crie integrações orientadas a eventos com Azure Databricks.

Os administradores também podem configurar destinos de notificação para receber solicitações de acesso de usuários do workspace, como solicitações de privilégio em objetos do Catálogo do Unity.

Você deve ser um administrador do workspace Azure Databricks para gerenciar destinos de notificação. Depois que um destino é configurado, ele está disponível para todos os usuários.

Requisitos de rede

Para destinos baseados em webhook, o endpoint receptor deve atender aos seguintes requisitos:

• Azure Databricks impõe o uso de HTTPS para segurança. O destino da notificação deve usar certificados de protocolo SSL assinados por uma autoridade de certificação confiável.
• O destino da notificação deve adicionar o plano de controle do workspace e os endereços IP de saída do plano de dados à sua lista de permissões:

  • Para obter endereços IP do webapp do plano de controle, consulte Endereços IP e domínios para serviços e ativos do Azure Databricks.

  • Para endereços IP de saída do plano de dados, consulte o ip-ranges.json arquivo que Azure Databricks publica. No arquivo, pesquise pela região do plano de dados do workspace e adicione a lista de endereços IP de saída correspondentes na configuração de rede.

    Azure Databricks pode atualizar os IPs de saída com a frequência de uma vez a cada 30 dias. Os IPs atualizados se tornam ativos em até 60 dias após a publicação, então, revise o arquivo regularmente e atualize sua lista de permitidos antes que a janela de ativação se feche.

    Para controlar as alterações entre versões, salve versões sucessivas do arquivo JSON e compare o timestampSeconds valor. Filtrar entradas em que:

    • O service campo é Databricks
    • O platform campo é azure
    • O type campo é outbound

Criar um novo destino de notificação

Para configurar um novo destino de notificação

1. Clique no nome de usuário na barra superior do workspace e selecione Configurações na lista suspensa.
2. Na seção de administração do workspace, clique na guia Notificações.
3. Clique no botão Gerenciar.
4. Clique em +Adicionar destino.
5. Selecione um tipo de destino. Atualmente, há suporte para os seguintes destinos:
   • Email
   • Slack
   • Webhook, com autenticação OAuth opcional (Beta)
   • Equipes da Microsoft
   • PagerDuty
6. Configure o destino com base no tipo.
7. Clique em Criar.

Usar credenciais diferentes para cada destino

A configuração de um destino é armazenada com segurança criptografada em seu workspace Azure Databricks. Para destinos que exigem que você forneça uma URL ou credenciais, o Azure Databricks recomenda usar credenciais diferentes para cada destino configurado. Isso limita o impacto se um endpoint de terceiros for comprometido. Estão incluídos:

• Slack usando um webhook: a URL para a qual a notificação é enviada.
• Microsoft Teams usando um webhook: a URL para a qual a notificação é enviada.
• PagerDuty: chave de integração usada para rotear notificações exclusivamente para um serviço PagerDuty.
• Webhook: um nome de usuário e senha para autenticação HTTP Basic, ou um ID de cliente e um segredo de cliente para autenticação OAuth (Beta).

O uso de segredos diferentes para cada destino configurado permite revogar individualmente o acesso de destinos de notificação individuais sem afetar a operação de todos os outros destinos em seu workspace Azure Databricks.

Autenticação OAuth para destinos de webhook

Use as credenciais do cliente OAuth 2.0 para enviar notificações a um endpoint que exija um token de acesso. O Azure Databricks obtém o token do seu provedor de identidade e o usa para autenticar a solicitação de notificação.

Seu fornecedor de identidade deve apoiar a concessão de credenciais do cliente. Tanto o endpoint receptor quanto o endpoint de token devem usar HTTPS.

Para criar um destino de webhook OAuth:

1. Nas Notificações de Configurações>, clique em Gerenciar, depois +Adicionar destino.
2. Digite um nome e selecione Webhook para Tipo.
3. Para o modo de Autenticação, selecione OAuth.
4. Insira os seguintes valores:
   • URL: O endpoint que recebe notificações.
   • ID do cliente e segredo do cliente: As credenciais emitidas pelo seu provedor de identidade.
   • URL do endpoint de token: O endpoint do qual o Azure Databricks obtém um token de acesso.
   • Escopos e Audiência: Insira estes valores opcionais, se exigido pelo seu provedor de identidade. Separe múltiplos escopos com vírgulas.
5. Clique em Criar.

O ID do cliente, o segredo do cliente e a URL do endpoint do token devem ser fornecidos em conjunto. OAuth não pode ser combinado com autenticação HTTP Basic.

Para verificar a configuração, abra o menu de três pontos do destino e clique em Testar. Azure Databricks obtém um token de acesso e envia uma notificação de exemplo. Se o teste falhar, verifique as credenciais, escopos, audiência, permissões do receptor e acesso à rede para ambos os endpoints.

Destino do Slack

Para configurar um destino baseado em webhooks no Slack, siga as instruções em Incoming webhooks para o Slack. Cole a URL gerada no destino da notificação Azure Databricks. Para usar o aplicativo Databricks Genie, veja os destinos dos aplicativos Slack e Microsoft Teams Genie.

Destinos do aplicativo Slack e Microsoft Teams Genie

Use o aplicativo Databricks Genie para conectar seu espaço de trabalho do Slack ou o locatário do Microsoft Teams ao seu espaço de trabalho do Azure Databricks. Depois, selecione um canal disponível como destino de notificação.

Você pode usar os destinos do app Genie com os seguintes recursos:

• Alertas SQL: Slack e Microsoft Teams.
• Solicitações de acesso ao Catálogo Unity: Slack e Microsoft Teams.
• Notificações do endpoint de Model Serving: Slack.

Criar um destino para um aplicativo Genie

Antes de criar um destino de aplicativo Genie, você deve instalar o aplicativo Databricks Genie para Slack ou Microsoft Teams, conectá-lo ao seu espaço de trabalho do Azure Databricks e adicioná-lo ao canal que recebe notificações. Para detalhes sobre a instalação do aplicativo e etapas de conexão, veja Slack ou Microsoft Teams.

Para criar um destino de aplicativo Genie:

1. Nas Notificações de Configurações>, clique em Gerenciar, depois +Adicionar destino.

2. Para Type, selecione Slack ou Microsoft Teams, depois selecione Use Databricks App.

3. Insira um nome para o destino.

4. Selecione o espaço de trabalho ou inquilino e o canal:

   • Para o Slack, selecione o Workspace e o Canal do Slack.
   • Para Microsoft Teams, selecione o Tenant e o Canal. O seletor de inquilino identifica cada inquilino pelos últimos seis caracteres de seu ID de inquilino.

   Se nenhum workspace do Slack ou tenants do Microsoft Teams estiver conectado, clique em Conecte um workspace do Slack ou Conecte um tenant do Teams, respectivamente, e complete a configuração do app Genie. Volte ao formulário de destino e clique em Atualizar. Se você acabou de adicionar o app Genie a um canal, clique em Recarregar canais para atualizar a lista de canais.

5. Clique em Criar.

Destino do PagerDuty

Para configurar um destino PagerDuty:

1. No PagerDuty, adicione uma integração ao seu serviço e selecione o tipo de integração Events API V2 .
2. Copie a chave de integração que o PagerDuty gera para a integração.
3. No Azure Databricks, cole a chave de integração no destino de notificação do PagerDuty.

Adicionar um webhook a um trabalho

Depois de configurar destinos, você pode acessá-los nas configurações de notificações de trabalho de um trabalho. Para obter mais informações, consulte Adicionar notificações a uma tarefa.

Cada trabalho dá suporte a até três destinos do sistema por tipo de evento. Ao configurar notificações de trabalho, os endereços de email devem ser inseridos manualmente.

Limitações

Atualmente, os destinos de notificação têm as seguintes limitações:

• Os destinos de notificação por email têm um limite de 1.300 caracteres de comprimento para o endereço do destinatário.
• Para corpos de notificação personalizados, destinos que não sejam de e-mail, como Slack e Microsoft Teams, não suportam formatação HTML. Alguns destinos de notificação dão suporte ao markdown.
• Para trabalhos, os destinos de email devem ser definidos manualmente nas configurações do trabalho.