Gerenciar destinos de notificação

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

As 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 defeito, as notificações são enviadas para endereços de email dos utilizadores, mas os administradores podem configurar destinos alternativos de notificações usando webhooks ou a aplicação Databricks Genie para Slack e Microsoft Teams (Beta). Isto permite-lhe construir integrações orientadas a eventos com o Azure Databricks.

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

Tem de ser administrador do Azure Databricks workspace para gerir destinos de notificações. Depois que um destino é configurado, ele fica disponível para todos os usuários.

Requisitos de rede

Para destinos baseados em webhook, o endpoint recetor deve cumprir os seguintes requisitos:

• O Azure Databricks impõe o uso do HTTPS para segurança. O destino da notificação deve usar certificados SSL (Secure Sockets Layer) assinados por uma autoridade de certificação confiável.
• O destino da notificação deve adicionar tanto o plano de controlo do espaço de trabalho como os endereços IP de saída do plano de dados à sua lista de permissões:

  • Para endereços IP de aplicações web do plano de controlo, veja os endereços IP e os domínios para os serviços e os ativos do Azure Databricks.

  • Para endereços IP de saída do plano de dados, consulte o ip-ranges.json ficheiro que o Azure Databricks publica. Pesquise no ficheiro a região da camada de dados do seu espaço de trabalho e coloque na lista de permissões os endereços IP de saída correspondentes na sua infraestrutura de rede.

    O Azure Databricks pode atualizar os IPs de saída até uma vez a cada 30 dias. IPs atualizados tornam-se ativos até 60 dias após a publicação, por isso revise o ficheiro regularmente e atualize a sua lista de permissões antes do encerramento da janela de ativação.

    Para acompanhar as alterações entre lançamentos, guarde as versões sucessivas do ficheiro JSON e compare o timestampSeconds valor. Filtrar entradas onde:

    • 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 seu nome de utilizador na barra superior da área de trabalho e selecione Definições na lista pendente.
2. Na seção 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. Os seguintes destinos são atualmente suportados:
   • Email
   • Slack
   • Webhook, com autenticação OAuth opcional (Beta)
   • Microsoft Teams
   • PagerDuty
6. Configure o destino com base no tipo.
7. Clique em Criar.

Use credenciais diferentes para cada destino

A configuração de um destino é armazenada de forma segura e encriptada no seu espaço de trabalho do Azure Databricks. Para destinos que exigem que forneça um URL ou credenciais, o Azure Databricks recomenda usar credenciais diferentes para cada destino configurado. Isto limita o impacto se um endpoint de terceiros for comprometido. Estes são, entre outros:

• Slack com um webhook: o endereço URL para o qual a notificação é enviada.
• Microsoft Teams usando um webhook: a URL para onde a notificação é enviada.
• PagerDuty: chave de integração usada para encaminhar notificações exclusivamente para um serviço PagerDuty.
• Webhook: um nome de utilizador e palavra-passe para autenticação HTTP Basic, ou um ID de cliente e um segredo de cliente para autenticação OAuth (Beta).

Usar diferentes segredos para cada destino configurado permite-lhe revogar individualmente o acesso a destinos individuais de notificações sem afetar a operação de todos os outros destinos no seu espaço de trabalho do 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 requer um token de acesso. O Azure Databricks obtém o token do seu fornecedor de identidade e usa-o para autenticar o pedido de notificação.

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

Para criar um destino de webhook OAuth:

1. Em Definições>Notificações, clique em Gerir e, em seguida, +Adicionar destino.
2. Introduza um nome e selecione Webhook para o Tipo.
3. Para o modo de Autenticação, selecione OAuth.
4. Introduza os seguintes valores:
   • URL: O endpoint que recebe notificações.
   • ID do cliente e segredo do cliente: As credenciais emitidas pelo seu fornecedor de identidade.
   • URL do endpoint do token: O endpoint a partir do qual o Azure Databricks obtém um token de acesso.
   • Âmbitos e Audiência: Introduza estes valores opcionais, se forem exigidos pelo seu fornecedor de identidade. Separe múltiplos escopos com vírgulas.
5. Clique em Criar.

O ID do cliente, o segredo do cliente e o endereço URL do ponto final do token são todos necessários. O OAuth não pode ser combinado com a 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, os âmbitos, o destinatário, as permissões do recetor e o acesso de rede a ambos os pontos de extremidade.

Destino do Slack

Para configurar um destino baseado em webhooks no Slack, siga as instruções em Webhooks recebidos para o Slack. Cole o URL gerado no seu destino de notificação do Azure Databricks. Para usar a aplicação Databricks Genie em vez disso, consulte os destinos das aplicações Slack e Microsoft Teams Genie.

Destinos das aplicações Slack e Microsoft Teams Genie

Use a aplicação Databricks Genie para ligar o seu espaço de trabalho Slack ou o inquilino Microsoft Teams ao seu espaço de trabalho Azure Databricks. Depois seleciona um canal disponível como destino de notificação.

Pode usar os destinos da aplicação Genie com as seguintes funcionalidades:

• Alertas SQL: Slack e Microsoft Teams.
• Pedidos de acesso ao Catálogo Unity: Slack e Microsoft Teams.
• Notificações do ponto final de disponibilização de modelos: Slack.

Criar um destino para a aplicação Genie

Antes de criar um destino para a aplicação Genie, deve instalar a aplicação Databricks Genie para Slack ou Microsoft Teams, ligá-la ao seu espaço de trabalho Azure Databricks e adicioná-la ao canal que recebe notificações. Para detalhes sobre a instalação da aplicação e passos de ligação, consulte Slack ou Microsoft Teams.

Para criar um destino para a aplicação Genie:

1. Em Definições>Notificações, clique em Gerir e, em seguida, +Adicionar destino.

2. Para Type, selecione Slack ou Microsoft Teams, depois selecione Usar a Aplicação Databricks.

3. Introduza um nome para o destino.

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

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

   Se não houver espaços de trabalho Slack ou inquilinos do Microsoft Teams ligados, clique em Ligar um espaço de trabalho Slack ou Ligar um tenant Teams, respetivamente, e complete a configuração da aplicação Genie. Volte ao formulário de destino e clique em Atualizar. Se acabaste de adicionar a aplicação Genie a um canal, clica em Recarregar canais para atualizar a lista de canais.

5. Clique em Criar.

Destino 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 os 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 num trabalho.

Cada trabalho suporta até três destinos do sistema por tipo de evento. Ao configurar notificações de trabalho, os endereços de e-mail devem ser inseridos manualmente.

Limitações

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

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