Pular para o conteúdo principal

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 entra no Jira Cloud com um email de account e seu token de API.

Pré-requisitos​

Configurar Jira​

  • Uma instância do Jira acessível via HTTPS a partir da internet pública. O Lakewatch não pode entregar para redes privadas, como Endpoint atrás de Private Link.
  • Uma account Jira que pode criar e atualizar issues no projeto de destino.
  • Um token de API para essa account. Crie-o nas configurações da sua account Atlassian.

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

Armazene o token da API do Jira em um segredo do Unity Catalog no esquema __lakewatch do catálogo do seu ambiente do Lakewatch. Selecionar segredo lista segredos desse esquema e Criar segredo cria um lá. O Lakewatch armazena apenas o nome do segredo, não o valor dele.

Você pode criar este secret com antecedência em <catalog>.__lakewatch ou criá-lo ao configurar a exportação do Jira com o botão Criar secret . De qualquer forma, a criação de um secret exige USE CATALOG no catálogo e a propriedade do esquema __lakewatch, ou as permissões CREATE SECRET e USE SCHEMA nele. Para ver os passos, consulte Criar um secret.

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.
  • O privilégio MANAGE no catálogo do seu ambiente Lakewatch. Consulte Definir configurações.

Para alterar o token da API, atualize o valor do mesmo segredo do Unity Catalog. O Lakewatch usa o novo valor na próxima exportação, sem alterações nas configurações. Para usar um segredo diferente, clique em Selecionar segredo ou Criar segredo nas configurações e salve.

Configurar o Jira como um destino de alerta​

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. Em Entrega , defina destino de alerta como Jira .
  3. Na URL da instância do Jira , insira a instância do Jira em que os problemas são arquivados, por exemplo https://acme.atlassian.net.
  4. Em key do projeto , digite o projeto no qual os issues são criados.
  5. Em Email do usuário , insira o email da account que está emparelhado com o token da API.
  6. Para segredo de token de API , clique em Selecionar segredo para escolher o segredo que contém o token de API, ou clique em Criar segredo para criar um a partir do token de API sem sair da página. O campo mostra o nome do segredo, não o valor dele.
  7. Em Tipo de problema default , insira o tipo de problema a ser criado, como Task ou Incident. Este campo é obrigatório e o Lakewatch não preenche um valor default. Se o projeto não tiver esse tipo de problema, o Jira rejeita a exportação.
  8. 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, o segredo está em um catálogo diferente do seu ambiente Lakewatch ou a URL da instância não usa HTTPS ou aponta para uma rede privada. Confirme seu acesso ao segredo, ao seu catálogo e à URL da instância.
  • Seu segredo não está listado em Selecionar segredo : Selecionar segredo lista apenas os segredos aos quais você tem acesso no esquema __lakewatch do catálogo do seu ambiente. Armazene o segredo lá ou peça READ SECRET nele.
  • 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.