Pular para o conteúdo principal
Última atualização em

Jira

info

Visualização

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

Exporte alertas do Lakewatch para o Jira como issues. Quando um alerta é criado, o Lakewatch cria uma issue do Jira e a atualiza conforme o alerta muda. Para saber como a exportação se comporta entre os destinos, consulte Destinos de alertas.

A exportação para o Jira é de sentido único, do Lakewatch para o Jira. O Lakewatch autentica-se no Jira Cloud com um email de usuário e um token de API como credencial de autenticação básica.

Pré-requisitos​

Configurar Jira​

  • Uma account Jira que pode criar e atualizar issues no projeto de destino.
  • Um token de API para essa account, emparelhado com o email da account como a credencial de autenticação básica do Jira Cloud. Crie tokens de API nas configurações da sua account Atlassian.

Armazene o token da API como um segredo do Unity Catalog​

O Lakewatch lê o token da API do Jira 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 seu valor.

Você pode criar este segredo antes do tempo ou criá-lo em linha ao configurar a exportação do Jira 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 obrigatórias​

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

  • READ SECRET no segredo do Unity Catalog que contém o token da API, ou no seu esquema ou catálogo pai. O Lakewatch verifica se você pode ler o segredo quando salva a configuração. Para concedê-lo, 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 próprio token da API como sua Service Principal. Como o Lakewatch lê o segredo por nome cada vez que exporta, a rotação do segredo é totalmente automática: basta atualizar 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.

Configurar exportação do Jira​

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

  1. Na barra lateral do Lakewatch, vá para Configurações e, em seguida, abra Alertas .
  2. Localize a configuração Exportar em Alertas .
  3. Defina o destino de exportação como Jira .
  4. Para Workspace , mantenha o workspace atual, a menos que o destino esteja atrás da rede de um workspace específico, como um endpoint PrivateLink ou um serviço com restrição de região. A rede deste workspace fornece a exportação.
  5. Em Instance URL , insira a instância do Jira em que os problemas são arquivados, por exemplo https://acme.atlassian.net.
  6. Em key do projeto , digite o projeto no qual os issues são criados.
  7. Em Email do usuário , insira o email da account que está emparelhado com o token da API.
  8. Defina o token de API para o segredo do Unity Catalog que contém o token de API do Jira. Digite ou cole seu nome de três níveis (catalog.schema.secret), clique em Select secret para escolher um segredo existente ou clique em Create secret para criar um a partir do token de API sem sair da página. Depois de salvar, o campo de segredo torna-se somente leitura; para atualizá-lo, gire o segredo no Unity Catalog.
  9. Em Tipo de problema Default , defina opcionalmente o tipo de problema a ser criado, por exemplo, Task.
  10. Salve as suas alterações.

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

Solução de problemas​

  • Problemas não são criados no Jira : o URL da instância ou a key do projeto estão errados, ou a account não consegue criar problemas no projeto. Confirme o URL da instância, a key do projeto e que a account e o token da API podem criar problemas no projeto.
  • 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.
  • Falha na autenticação : o email do usuário ou o token de API está incorreto. Confirme se o email é a account pareada com o token e se o token armazenado no segredo é válido.
  • Você rotacionou o token de API : atualize o segredo do Unity Catalog com o novo valor. Nenhuma alteração na configuração de exportação é necessária.
Nesta página