Tines

info

Visualização

O Lakewatch está em Pré-visualização privada. Para solicitar acesso, entre em contato com a equipe da sua conta da Databricks.

Exporte alertas do Lakewatch para uma história do Tines. Quando um alerta é criado, o Lakewatch publica um evento JSON em um webhook do Tines, e sua história do Tines decide o que acontece com ele. Para saber como a exportação funciona entre destinos, consulte Destinos de alertas.

A exportação para o Tines é unidirecional, do Lakewatch para o Tines. O Lakewatch envia o evento por meio de uma ação de webhook do Tines, autenticando-se com um segredo de webhook que você armazena como um segredo do Unity Catalog.

Como o evento é entregue

• Na criação de alerta : o Lakewatch posta um evento JSON com o event_type lakewatch.alert.created. O payload usa o mesmo esquema e nomes de campos que o destino de webhook genérico, portanto, uma história do Tines pode ler os mesmos campos.
• Em atualizações de alertas : quando a entrega de atualização está habilitada para o destino, o Lakewatch também publica um evento lakewatch.alert.updated para alterações posteriores em um alerta já exportado. Para habilitar a entrega de atualização, consulte Configurar definições.
• Sua história decide o resultado : o Lakewatch entrega o evento para sua história Tines. Uma resposta 2xx significa que o Tines aceitou o evento, não que sua história agiu sobre ele. Se o Lakewatch relatar uma exportação bem-sucedida, mas nada acontecer no Tines, verifique a lógica da sua história em vez da configuração de exportação.

atenção

A entrega é no máximo uma vez. Se um POST para o Tines falhar, o Lakewatch registrará a falha, mas não reexecutará, e o evento não será reenviado. O alerta ainda é criado no Lakewatch.

Para evitar o processamento do mesmo alerta duas vezes, correlacione os eventos na sua história Tines no campo data.alert_id. Não desduplique em delivery_attempt_id, que é um novo valor em cada entrega. Se a entrega de atualização estiver habilitada, você receberá mais de um evento para o mesmo alert_id (um evento created e eventos updated posteriores), portanto, distingua-os por event_type em vez de colapsá-los em alert_id.

Pré-requisitos

Configurar o webhook do Tines

Em sua história do Tines, adicione uma ação de webhook de entrada e configure-a para autenticar com um segredo:

1. Adicione uma ação de Webhook à sua história.
2. Defina a ação para exigir um segredo, enviado como um cabeçalho (modo de acesso secreto). Observe a URL do webhook e o segredo.

Para obter detalhes, consulte a documentação da ação do webhook Tines.

O URL do webhook deve ser um URL de ação do webhook, na forma https://<tenant>.tines.com/webhook/<path>.

Armazene o segredo do webhook como um segredo do Unity Catalog

O Lakewatch lê o segredo do webhook de um segredo do Unity Catalog, um item protegível com um nome de três níveis na forma catalog.schema.secret, cada vez que exporta um alerta. O Lakewatch armazena apenas o nome do segredo, não o valor do segredo.

Você pode criar esse segredo com antecedência ou criá-lo em linha ao configurar a exportação do Tines com o botão Criar segredo . De qualquer forma, criar um segredo requer USE CATALOG no catálogo e a propriedade do esquema ou ambos CREATE SECRET e USE SCHEMA no esquema. Para os passos, consulte Criar um segredo.

Permissões necessárias

Para configurar a exportação do Tines, você precisa do seguinte:

• READ SECRET no segredo do Unity Catalog que contém o segredo do webhook, ou no esquema ou catálogo pai dele. O Lakewatch verifica se você pode ler o segredo quando você salva a configuração. Para concedê-la, consulte Gerenciar permissões em segredos.
• Permissão para editar a configuração de exportação de alertas nas configurações do workspace.

No momento da exportação, o Lakewatch lê o segredo do webhook como seu Service Principal. Como o Lakewatch lê o segredo pelo nome toda vez que exporta, a rotação do segredo é totalmente automática: atualize o segredo do Unity Catalog e o Lakewatch usará o novo valor na próxima exportação, sem nenhuma alteração na configuração de exportação.

Configure a exportação do Tines

Configure um destino Tines para alertas na seção de configurações de Alertas .

1. Na barra lateral do Lakewatch, vá para Configurações e abra Alertas .
2. Encontre a configuração Exportar em Alertas .
3. Defina o destino de exportação como Tines .
4. Para Workspace , mantenha o workspace atual, a menos que o destino esteja atrás de uma rede de um workspace específico, como um endpoint PrivateLink ou um serviço com restrição regional. A rede deste workspace entrega a exportação.
5. No URL do webhook , insira o URL da ação de webhook do Tines (https://<tenant>.tines.com/webhook/<path>).
6. Defina Segredo do webhook como o segredo do Unity Catalog que contém o segredo do webhook. Digite ou cole seu nome de três níveis (catalog.schema.secret), clique em Selecionar segredo para escolher um segredo existente ou clique em Criar segredo para criar um a partir do segredo do webhook sem sair da página. Depois de salvar, o campo de segredo se torna somente leitura; para atualizá-lo, rotacione o segredo no Unity Catalog.
7. Salvar suas alterações.

Para obter a referência completa das configurações de alerta, consulte Definir configurações.

Solução de problemas

• Os eventos não chegam à sua story : o URL do webhook não é um URL de ação de webhook do Tines ou a story está desativada. Confirme se o URL está no formulário https://<tenant>.tines.com/webhook/<path> e se a story está ativa.
• A configuração não é salva : você não tem permissão para ler o segredo do Unity Catalog ou o nome do segredo não está no formato catalog.schema.secret. Confirme seu acesso ao segredo e ao nome do segredo.
• O Lakewatch relata uma exportação bem-sucedida, mas nada acontece no Tines : uma resposta 2xx significa que o Tines aceitou o evento, não que sua história agiu sobre ele. Verifique a lógica da sua história do Tines.
• Você girou o segredo do webhook : atualize o segredo do Unity Catalog com o novo valor. Nenhuma alteração na configuração de exportação é necessária.