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 padrão, as notificações são enviadas para os endereços de e-mail dos usuários, mas os administradores podem configurar destinos de notificação alternativos usando webhooks. 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

  • 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, entre em contato com a sua equipa de conta do Azure Databricks. Receberá uma URL para um ficheiro JSON contendo os endereços IP de saída. 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
    • 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 melhorar a segurança caso o endpoint de terceiros seja comprometido, o Azure Databricks recomenda o uso de credenciais diferentes para cada destino configurado. Estes são, entre outros:

  • Slack: o URL para o qual a notificação é enviada.
  • MS Teams: o URL para o qual a notificação é enviada.
  • PagerDuty: chave de integração usada para encaminhar notificações exclusivamente para um serviço PagerDuty.
  • Webhook: nome de utilizador e senha usados para autenticar num endpoint de terceiros usando autenticação HTTP Basic ao entregar notificações.

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.

Destino Slack

Para configurar um destino do Slack, siga as instruções em Webhooks de entrada para o Slack. Cole o URL gerado no seu destino de notificação do Azure Databricks.

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:

  • Você só pode configurar notificações para Databricks SQL e trabalhos.
  • 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 e-mail, como o Slack e o MS 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.
  • Last updated on