Conéctate a una fuente de datos de Jira - Amazon Managed Grafana

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Conéctate a una fuente de datos de Jira

Obtén una visión completa de tu proceso de desarrollo combinando los datos de problemas de Jira con los datos de rendimiento de las aplicaciones de otras fuentes.

nota

Esta fuente de datos es solo para Grafana Enterprise. Para obtener más información, consulte Gestione el acceso a los complementos empresariales.

Además, en los espacios de trabajo compatibles con la versión 9 o posterior, es posible que esta fuente de datos requiera la instalación del complemento adecuado. Para obtener más información, consulte Amplía tu espacio de trabajo con complementos.

  • Crea anotaciones en función de la creación o resolución de problemas para ver la relación entre los problemas y las métricas.

  • Realiza un seguimiento de las estadísticas detalladas de Jira, como el tiempo medio de resolución y el rendimiento de los problemas.

Para utilizar la fuente de datos de Jira, necesitas una cuenta de Atlassian con acceso a un proyecto de Jira.

Limitaciones conocidas

Es posible que no se admitan los tipos de campos personalizados de los complementos de Jira.

Añadir la fuente de datos

  1. Abre la consola de Grafana en el espacio de trabajo de Grafana gestionado por Amazon y asegúrate de haber iniciado sesión.

  2. En el menú lateral, en Configuración (el icono con forma de engranaje), selecciona Fuentes de datos.

  3. Elija Agregar origen de datos.

    nota

    Si no ves el enlace Fuentes de datos en el menú lateral, significa que tu usuario actual no tiene el Admin rol.

  4. Selecciona Jira de la lista de fuentes de datos.

  5. Introduzca la información siguiente:

    • En Nombre, introduce un nombre para esta fuente de datos de Jira.

    • En URL, introduce la URL raíz de tu instancia de Atlassian, como. https://bletchleypark.atlassian.net

    • En Usuario, introduce una dirección de correo electrónico para la cuenta de usuario o servicio.

    • Para el token de API, introduzca un token de API generado para el usuario.

Consulte la fuente de datos de Jira

En el editor de consultas de Jira, puedes seleccionar campos y consultar problemas.

La fuente de datos de Jira consulta a Jira en busca de problemas, que pueden representar errores, historias de usuarios, solicitudes de soporte u otras tareas de Jira

Filtra y visualiza los problemas
  1. Elige Campos, elige el menú desplegable y utiliza la tecla de teclado para seleccionar cualquiera de los campos de tu instancia de Jira, incluidos los campos personalizados. Algunos campos para probar:

    • Resumen: el nombre del problema

    • Nombre épico: la epopeya a la que pertenece un número

    • Estimación de puntos de la historia: el número de puntos de la historia que el equipo ha estimado para un número

  2. Filtra u ordena los problemas. Para ello, introduce cualquier expresión JQL válida para filtrar u ordenar los problemas en función de cualquiera de sus campos, como Project, Assignee o Sprint, con el lenguaje de consultas JQL de Atlassian.

Desde aquí, puede mostrar sus datos en una tabla o usar las transformaciones de Grafana para manipular esos datos de emisión, ejecutar cálculos o convertir los datos en un gráfico de series temporales. Para obtener más información, consulte Aplicar una transformación.

Consulta de series temporales

Para mostrar datos de series temporales, elija un campo de fecha junto con un campo numérico y, a continuación, cambie a la visualización de gráficos. Por ejemplo: fecha de inicio del sprint, estimación del punto de la historia.

El ejemplo anterior, por sí solo, no es muy útil. El campo numérico se puede calcular (y muy probablemente se calculará) a partir de transformaciones. El uso del método Agrupar por transformación permitiría agrupar por fecha de inicio del sprint y resumir la estimación de puntos de la historia, lo que permitiría visualizar los puntos de la historia a lo largo del tiempo por sprint. Para obtener más información sobre transformaciones, consulte Aplicar una transformación.

Plantillas y variables

Para añadir una nueva variable de consulta de Jira, consulteAñadir una variable de consulta. Utilice su fuente de datos de Jira como fuente de datos.

Puede definir variables en sus paneles y hacer referencia a ellas en las expresiones de JQL. Por ejemplo, puede crear un panel de estado de un proyecto y elegir entre proyectos, o un panel de estado épico y elegir diferentes epopeyas, o un panel de estado de tareas y elegir diferentes responsables.

Para obtener una lista dinámica de proyectos, epopeyas, personas asignadas, etc., entre las que elegir, crea una variable de tipo consulta. Las variables de tipo consulta utilizan JQL para consultar los problemas y devolver proyectos, epopeyas, personas asignadas o cualquier información relacionada con los problemas. A continuación, se muestra un ejemplo:

Cree una variable de cesionario para obtener el estado de los problemas por cesionario
  1. Agregue una variable de tipo Query denominada Query. assignee

  2. Seleccione el campo: cesionario.

  3. ) Opcional) Agregue un proyecto de filtro JQL = «su proyecto».

  4. Seleccione Ejecutar para ver una lista de personas asignadas.

  5. Elija Actualizar para añadir la variable al panel de control.

  6. Añada un panel nuevo al panel y edite el JQL para filtrarlo con la nueva variable assignee = $assignee.

    Ahora, al elegir una opción en el menú desplegable, solo verá las incidencias asignadas a ese usuario.

Las variables con varios valores permiten seleccionar varias opciones y se pueden usar como parte de la cláusula IN. Por ejemplo, assignee IN ($assignee).

Uso de las transformaciones de Grafana para responder a preguntas comunes

Las macros son variables que hacen referencia a la ventana temporal del panel, por lo que solo puede filtrar los problemas dentro del rango de la ventana del panel. Hay 2 macros:

  • $__TimeFrom

  • $__TimeTo.

El siguiente ejemplo de consulta de JQL filtra los problemas creados en la ventana de tiempo del panel de control: createdDate >= $__timeFrom AND createdDate <= $__timeTo

Aproveche al máximo la fuente de datos

El uso de las transformaciones de Grafana y otras funciones integradas puede ayudarte a ver tus datos de Jira de forma significativa.

Uso de transformaciones para mejorar JQL

Si bien hay muchas transformaciones en Grafana entre las que elegir, las siguientes proporcionan un potente aumento para dar a JQL algunas de las características y la potencia de SQL.

Agrupar por Esta transformación proporciona una función clave que no forma parte de la sintaxis JQL estándar de Jira: la agrupación. Con la transformación Agrupar por, puedes agrupar por sprints u otros campos de temas y agregar por grupo para obtener métricas como la velocidad y los argumentos estimados en comparación con el tiempo real completado en un sprint.

Combinación externa Al igual que en las uniones SQL, puedes unir 2 o más consultas mediante campos comunes. Esto proporciona una forma de combinar los conjuntos de datos de las consultas y utilizar otras transformaciones para calcular los valores de varias consultas o conjuntos de datos.

Agregar un campo a partir del cálculo Al igual que las expresiones de SQL, esta transformación permite agregar nuevos campos al conjunto de datos en función de los cálculos de otros campos. Los campos utilizados en el cálculo pueden provenir de una sola consulta o de consultas que hayas unido. También puede encadenar cálculos y realizar cálculos a partir de campos calculados.

Uso de las transformaciones de Grafana para responder a preguntas comunes

Puede usar las transformaciones para visualizar, agregar, agrupar y unir conjuntos de datos, junto con muchos otros tipos de transformaciones para transformar resultados simples en respuestas a preguntas complejas.

¿Cómo puedo mostrar la velocidad por sprint?

  1. Campos seleccionados: nombre del sprint, estimación de puntos de la historia.

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

  3. Añadir un grupo por transformación:

    • Nombre de Sprint | Agrupar por

    • Estimación del argumento | Calcular | Total

  4. Elija la visualización del indicador de barras.

¿Cómo puedo mostrar lo que se completó y lo que se estimó en un sprint?

  1. Agrega una consulta. Primero, selecciona los campos: nombre del sprint, fecha de inicio del sprint, estimación del argumento.

    Luego agrega un filtro JQL: project = 'Your Project' AND type != epic

  2. Añada una segunda consulta. Primero, selecciona Campos: Nombre del sprint, Fecha de inicio del sprint, Estimación del argumento.

    Luego agrega un filtro JQL: project = 'Your Project' AND type != epic AND status = done

  3. Añadir un grupo por transformación:

    • Nombre de Sprint | Agrupar por

    • Fecha de inicio del Sprint | Agrupar por

    • Estimación del argumento | Calcular | Total

  4. Elija la visualización gráfica.

¿Cuál es el tiempo promedio para completar los problemas de mi proyecto?

  1. Agrega una consulta. Primero, seleccione Campos: creados, categoría de estado cambiada.

    A continuación, añada un filtro JQL: project = 'Your Project' AND type != epic AND status = done

  2. Añadir una transformación: añadir un campo a partir del cálculo

    • Modo = Reducir fila

    • Cálculo = diferencia

  3. Añadir una transformación: añadir un campo a partir del cálculo

    • Modo = Operación binaria

    • Operación = Diferencia/86000000

    • Alias = Días

  4. Añadir una transformación: organiza los campos

    • Ocultar un campo diferente

  5. Añadir una transformación: filtra los datos por valores

    • Tipo de filtro = Incluir

    • condiciones = Coincide con cualquiera

      • Campo = días | Coincidencia = es mayor | Valor = 1

  6. Añadir una transformación: reducir

    • Modo = Serie a filas

    • Cálculos = media

  7. Elija la visualización de estadísticas.