Jira

Tenha uma visão geral do seu processo de desenvolvimento combinando dados de problemas do Jira com dados de desempenho de aplicativos de outras fontes.

• Crie anotações com base na criação ou resolução de problemas para ver a relação entre problemas e métricas.

• Acompanhe estatísticas detalhadas do Jira, como tempo médio de resolução e taxa de transferência de problemas.

Para usar a fonte de dados do Jira, você precisa de uma conta da Atlassian com acesso a um projeto do Jira.

Limitações conhecidas

Os tipos de campo personalizados dos complementos do Jira podem não ser suportados.

Adicionar a fonte de dados

1. Abra o console do Grafana no espaço de trabalho Amazon Managed Grafana e verifique se você está logado.

2. No menu lateral em Configuração (o ícone de engrenagem), escolha Fontes de dados.

3. Escolha Adicionar fonte de dados.

   nota

   Se você não vê o link Fontes de dados no menu lateral, isso significa que seu usuário atual não tem aAdmin função.

4. Selecione Jira na lista de fontes de dados.

5. Insira as seguintes informações:

   • Em Nome, insira um nome para essa fonte de dados do Jira.

   • Para URL, insira o URL raiz da sua instância da Atlassian, comohttps://bletchleypark.atlassian.net.

   • Para Usuário, insira um endereço de e-mail para a conta de usuário/serviço.

   • Para token de API, insira um token de API gerado para o usuário.

Consulte a fonte de dados do Jira

No Jira Query Editor, você pode selecionar campos e problemas de consulta.

A fonte de dados do Jira consulta o Jira em busca de problemas, que podem representar bugs, histórias de usuários, tíquetes de suporte ou outras tarefas no Jira

Filtrar e visualizar problemas

1. Escolha Campos, escolha o menu suspenso e use digitação antecipada para selecionar qualquer um dos campos em sua instância do Jira, incluindo campos personalizados. Alguns campos para testar:

   • Resumo — O nome do problema

   • Nome épico — O epíteto ao qual uma edição pertence

   • Estimativa de pontos da história — O número de pontos da história que a equipe estimou para um problema

2. Filtre ou classifique os problemas. Para fazer isso, insira qualquer expressão JQL válida para filtrar ou classificar os problemas com base em qualquer um de seus campos, como Projeto, Destinatário ou Sprint, com a linguagem de consulta Atlassian JQL.

A partir daqui, você pode exibir seus dados em uma tabela ou usar as transformações do Grafana para manipular os dados emitidos, executar cálculos ou transformar os dados em um gráfico de séries temporais. Para obter mais informações, consulte Aplicar uma transformação.

Consulta de séries temporais

Para mostrar dados de séries temporais, escolha um campo de data junto com um campo numérico e, em seguida, alterne para a visualização gráfica. Por exemplo: Data de início do Sprint, estimativa de pontos da história.

O exemplo anterior, por si só, não é muito útil. O campo numérico pode ser (e provavelmente será) calculado a partir de Transformações. Usar o Group By Transformation permitiria agrupar por data de início do Sprint e resumir a estimativa do ponto da história, permitindo uma visualização dos pontos da história ao longo do tempo por Sprint. Para obter mais informações sobre transformações, consulte Aplicar uma transformação.

Modelos e variáveis

Para adicionar uma nova variável de consulta do Jira, consulteAdicionar uma variável de consulta. Use sua fonte de dados do Jira como fonte de dados.

Você pode definir variáveis em seus painéis e referenciá-las em expressões JQL. Por exemplo, você pode criar um painel de status do projeto e escolher entre projetos, ou um painel de status épico e escolher épicos diferentes, ou um painel de status da tarefa e escolher diferentes destinatários.

Para obter uma lista dinâmica de projetos, épicos, destinatários e assim por diante para escolher, crie uma variável do tipo Query. As variáveis do tipo de consulta usam o JQL para consultar problemas e retornar projetos, épicos, responsáveis ou qualquer coisa relacionada a problemas. Veja um exemplo a seguir.

Crie uma variável do destinatário para obter o status de problemas do destinatário

1. Adicione uma variável do tipo Query namedassignee.

2. Selecione o campo: Destinatário.

3. ) Opcional) Adicione um projeto de filtro JQL = 'seu projeto'.

4. Escolha Executar para ver uma lista de destinatários.

5. Escolha Atualizar para adicionar a variável ao painel.

6. Adicione um novo painel ao painel e edite o JQL para filtrar usando sua nova variável assignee = $assignee.

   Agora, ao escolher no menu suspenso, você vê apenas os problemas atribuídos a esse usuário.

Variáveis de vários valores permitem selecionar várias opções e podem ser usadas como parte da cláusula IN. Por exemplo, destinatário IN ($assignee).

Usando transformações do Grafana para responder perguntas comuns

As macros são variáveis que fazem referência à janela de tempo do Dashboard para que você possa filtrar problemas somente dentro do intervalo da janela do Dashboard. Existem 2 macros:

• $__timeFrom

• $__timeTo.

O exemplo a seguir filtra problemas de consulta JQL criados na janela de tempo do painel:createdDate >= $__timeFrom AND createdDate <= $__timeTo

Tire o máximo proveito da fonte de dados

Usar as transformações do Grafana e outros recursos integrados pode ajudá-lo a visualizar seus dados do Jira de forma significativa.

Usando transformações para aumentar o JQL

Embora existam muitas transformações no Grafana para escolher, as seguintes fornecem um poderoso aprimoramento para dar ao JQL alguns dos recursos/poderes do SQL.

Agrupar por Essa transformação fornece um recurso importante que não faz parte da sintaxe padrão do Jira JQL: Agrupamento. Usando a transformação Agrupar por, você pode agrupar por Sprints ou outros campos de problema e agregar por grupo para obter métricas como estimativas de velocidade e pontos históricos versus dados reais concluídos em um Sprint.

Junção externa Semelhante às uniões SQL, você pode unir 2 ou mais consultas por campos comuns. Isso fornece uma maneira de combinar conjuntos de dados de consultas e usar outras transformações para calcular valores de várias consultas/conjuntos de dados.

Adicionar campo do cálculo Semelhante às expressões SQL, essa transformação permite adicionar novos campos ao seu conjunto de dados com base nos cálculos de outros campos. Os campos usados no cálculo podem ser de uma única consulta ou de consultas que você uniu. Você também pode agrupar cálculos e realizar cálculos a partir de campos calculados.

Usando transformações do Grafana para responder perguntas comuns

Você pode usar Transformações para visualizar, agregar, agrupar e unir conjuntos de dados, junto com muitos outros tipos de transformações para transformar resultados simples em respostas para perguntas complexas.

Como faço para mostrar a Velocidade por Sprint?

1. Selecione os campos: nome do sprint, estimativa do ponto da história.

2. Adicione um filtro JQL:project = "Your Project" AND type != epic AND status = done order by created ASC

3. Adicionar um grupo por transformação:

   • Nome do Sprint | Agrupar por

   • Estimativa de pontos históricos | Calcular | Total

4. Escolha a visualização do Bar Gauage.

Como faço para mostrar o que foi concluído versus estimado em um Sprint?

1. Adiciona uma consulta. Primeiro, selecione Campos: Nome do Sprint, Data de início do Sprint, Estimativa do ponto da história.

   Em seguida, adicione um filtro JQL:project = 'Your Project' AND type != epic

2. Adicione uma segunda consulta. Primeiro, selecione Campos: Nome do Sprint, Data de início do Sprint, Estimativa do ponto da história.

   Em seguida, adicione um filtro JQL:project = 'Your Project' AND type != epic AND status = done

3. Adicionar um grupo por transformação:

   • Nome do Sprint | Agrupar por

   • Data de início do Sprint | Agrupar por

   • Estimativa de pontos históricos | Calcular | Total

4. Escolha a visualização gráfica.

Qual é o tempo médio para concluir os problemas do meu projeto?

1. Adiciona uma consulta. Primeiro, selecione Campos: Criado, Categoria de status alterada.

   Em seguida, adicione um filtro JQL:project = 'Your Project' AND type != epic AND status = done

2. Adicionar uma transformação: Adicionar campo do cálculo

   • Modo = Reduzir linha

   • Cálculo = Diferença

3. Adicionar uma transformação: Adicionar campo do cálculo

   • Modo = Operação binária

   • Operação = Diferença/86000000

   • Alias = Dias

4. Adicione uma transformação: Organize campos

   • Ocultar campo diferente

5. Adicionar uma transformação: filtrar dados por valores

   • Tipo de filtro = Incluir

   • condições = Combine qualquer uma

     • Campo = Dias | Correspondência = É maior | Valor = 1

6. Adicione uma transformação: Reduzir

   • Modo = Série em linhas

   • Cálculos = média

7. Escolha a visualização Stat.