Conectar o Jira
O Jira complementa os dados de código com a camada de planejamento: tipo de issue, status (A fazer → Em progresso → Concluído), prioridade, story points, épicos e, o mais importante, a rastreabilidade entre ticket e PR. A conexão é por OAuth 3LO (somente leitura) e leva menos de um minuto.
Depois de conectar, veja Insights do Jira para tudo o que a integração habilita.
Visão geral#
Sozinho, o código conta metade da história: o que foi entregue. O Jira conta a outra metade: o que foi planejado e em que estágio cada trabalho está. Ao ligar os dois, a Mensor mostra o fluxo completo do ticket → produção, mede cobertura (quanto do trabalho de código está ligado a um ticket) e habilita os insights de value stream, investimento por tipo, triagem, story points e épicos.
A conexão é somente leitura via OAuth 3LO (three-legged OAuth da Atlassian): a Mensor lê os dados dos projetos que você ativar, mas nunca cria, edita nem move issues.
Privacidade: acesso somente leitura; o token é criptografado (AES-256) no banco; a plataforma lê metadados de planejamento, não o conteúdo do seu código.
Pré-requisitos#
- Ser Owner ou Admin da organização na plataforma Mensor para conectar a integração.
- Ter acesso aos projetos do Jira que deseja acompanhar.
- (Opcional, para tempo real) acesso de administrador do Jira para cadastrar o webhook.
Passo a passo#
- No menu lateral, abra Integrações.
- No card do Jira, clique em Conectar.
- Você será redirecionado ao Atlassian para autorizar o acesso (leitura). Revise e confirme.
- De volta à plataforma, selecione os projetos do Jira que deseja acompanhar e clique em Ativar.
- Pronto: a sincronização começa em segundo plano.
Conectar uma integração requer ser Owner ou Admin da organização na plataforma.
O que é sincronizado#
Para cada projeto que você ativar, a plataforma importa:
- Issues: tipo, status (mapeado para A fazer → Em progresso → Concluído), prioridade, responsável e datas.
- Story points de cada issue.
- Épicos e a relação de issues com seus épicos.
- Ligação ticket ↔ PR (ver abaixo), base da cobertura e do fluxo ticket → produção.
Rastreabilidade ticket ↔ PR#
A plataforma reconhece a chave do ticket do Jira (ex.: PROJ-123) mencionada no PR e liga os dois
automaticamente. A chave é procurada no:
- Título do PR (ex.:
PROJ-123: corrige login) - Nome da branch (ex.:
feature/PROJ-123-corrige-login) - Descrição do PR
Quando a chave casa, o ticket passa a aparecer ligado ao PR, e isso alimenta a cobertura, o value stream e o fluxo ticket → produção.
Dica: nomeie PRs para casar com tickets#
Para o link funcionar sem esforço, basta o time seguir a prática comum de incluir a chave do ticket na branch ou no título do PR:
- Branch:
feature/PROJ-123-descricao-curta - Título:
PROJ-123: descrição do que mudou
Quanto mais consistente o time for em referenciar a chave do ticket, maior fica a cobertura medida na Mensor (a fração de trabalho de código rastreável até um ticket de planejamento).
Atualização dos dados#
Por padrão, a plataforma re-sincroniza o Jira periodicamente. Para refletir mudanças em segundos, há uma opção de tempo real via webhook (opcional):
- Na página Gerenciar projetos (do Jira), copie a URL do webhook.
- Peça ao administrador do Jira para adicioná-la em Configurações → Sistema → WebHooks.
Sem o webhook, os dados continuam atualizando periodicamente; o tempo real apenas torna a atualização quase instantânea.
Solução de problemas (FAQ)#
Os tickets aparecem, mas não estão ligados a nenhum PR#
A ligação depende da chave do ticket estar presente no título, branch ou descrição do PR. Reforce a
convenção de nomenclatura com o time (ex.: PROJ-123: ...). PRs antigos sem a chave não serão ligados
retroativamente.
Não vejo um projeto na lista#
Confirme que você tem acesso ao projeto no Jira e que ele foi ativado na tela Gerenciar projetos. Apenas projetos ativados são sincronizados.
As mudanças no Jira demoram a aparecer#
Sem o webhook, a sincronização é periódica. Configure o tempo real (ver acima) para refletir mudanças em segundos.
Por que a conexão é somente leitura?#
A Mensor só precisa ler o planejamento para calcular métricas e rastreabilidade. Ela nunca cria, edita ou move issues no seu Jira.
Desconectar#
No card do Jira em Integrações, clique em Desconectar. Os dados sincronizados do Jira (issues, projetos e links) são removidos; os dados do GitHub e do Azure não são afetados.
Próximos passos#
- Insights do Jira: rastreabilidade, value stream, investimento por tipo, triagem, story points, épicos e o fluxo ticket → produção.
- Se ainda não conectou o código, comece pelo GitHub ou pelo Azure DevOps.
- Veja a visão geral das integrações.