Conectarse a una fuente GitLab de datos

La fuente de GitLab datos le permite realizar un seguimiento de GitLab estadísticas detalladas, como los principales contribuyentes, las confirmaciones por día o las implementaciones por día. También puede usar variables de plantilla, como los proyectos, para configurar filtros para sus paneles. Puede combinar datos de la GitLab API con datos 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.

Limitaciones conocidas

Este complemento aún no admite las alertas porque las transformaciones no se admiten en las consultas de alertas y las transformaciones son la única forma de obtener métricas agregadas significativas a partir de los datos sin procesar de la GitLab API.

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. Seleccione una GitLabde las fuentes de datos de la lista.

5. Introduzca la información siguiente:

   • En Nombre, introduzca un nombre para esta fuente GitLab de datos.

   • En URL, introduce la URL raíz de la GitLab instancia, por ejemplohttps://gitlab.com/api/v4.

   • En el caso del token de acceso, introduce tu token de acceso GitLab personal.

Consulte la fuente GitLab de datos

En el editor de GitLab consultas, puede seleccionar distintos tipos de recursos, como confirmaciones, incidencias o publicaciones.

Filtrar y ver proyectos

1. En el menú desplegable, selecciona Proyectos.

2. (Opcional) Filtra por los proyectos que son de tu propiedad.

3. Usa el menú desplegable y selecciona Sí o No para filtrar los resultados.

   nota

   Buscar todos los proyectos Owned = No puede llevar mucho tiempo.

Filtra y visualiza las confirmaciones

1. En el menú desplegable, selecciona Confirmaciones.

2. Usa el campo de entrada para añadir el ID del proyecto.

3. (Opcional) Para filtrar por rama/etiqueta, usa el campo de entrada para agregar una referencia de rama/etiqueta.

Filtra y visualiza los problemas

1. En el menú desplegable, selecciona Problemas.

2. Usa el campo de entrada para añadir el ID del proyecto.

3. (Opcional) Para filtrar por título o descripción, usa el campo de entrada para buscar temas en función de su título y descripción.

Ver las publicaciones

1. En el menú desplegable, selecciona Implementaciones.

2. Usa el campo de entrada para añadir el ID del proyecto.

3. (Opcional) Para filtrar por entorno o estado, usa los campos de entrada. El atributo de estado puede tener uno de los siguientes valores:created,, running successfailed, o. canceled

Ver etiquetas

1. En el menú desplegable, selecciona Etiquetas.

2. Usa el campo de entrada para añadir el ID del proyecto.

Plantillas y variables

Para añadir una nueva variable de GitLab consulta, consulteAñadir una variable de consulta. Utilice su fuente de GitLab datos como fuente de datos. Elija un tipo de recurso: versiones, proyectos o etiquetas.

Para obtener una lista dinámica de proyectos, etiquetas, etc. entre los que elegir, cree una variable de tipo consulta. Las variables de tipo GitLab consulta utilizan el editor de consultas para consultar y devolver proyectos, etiquetas, etc. En el siguiente ejemplo, se crea una variable de proyecto para parametrizar las consultas

Cree una variable de proyecto para parametrizar las consultas

1. Agregue una variable de tipo Query denominada Query. project

2. Seleccione su fuente GitLab de datos y actualice On Dashboard Load.

3. Seleccione el tipo de recurso del proyecto, Sí para Owned, nombre para el campo de visualización e id para el campo de valor.

4. Seleccione Actualizar para añadir la variable al panel de control.

5. Añada un panel nuevo al panel de control y $project utilícelo como ID del proyecto.

   Ahora, al elegir una opción del menú desplegable, obtendrás los resultados que pertenecen a ese proyecto.

Uso de las transformaciones de Grafana para responder a preguntas comunes

Ahora que puede realizar GitLab consultas básicas para encontrar confirmaciones, problemas, etc., puede usar las transformaciones para visualizar, agregar, agrupar y unir conjuntos de datos, junto con muchos otros tipos de transformaciones para transformar los resultados simples en respuestas a preguntas complejas. A continuación, se muestran algunas preguntas frecuentes y cómo utilizar las transformaciones para responderlas.

¿Cuántas confirmaciones, problemas o despliegues hay en mi proyecto por día?

1. Agrega una consulta. Seleccione Confirmaciones para el tipo de recurso y añada el ID del proyecto.

2. Agregue un nuevo grupo mediante transformación: en Agrupar por, seleccione created_at_date y, a continuación, calcule (Count) =id

3. Elija la visualización del gráfico.

¿Cuál es el tiempo medio que se tarda en cerrar los problemas de mi proyecto?

1. Agrega una consulta. Seleccione Issues para el tipo de recurso y añada el ID del proyecto.

2. Agregue un nuevo campo a partir de la transformación del cálculo: para Modo, seleccione Operación binaria, para Operación, seleccione closed_at = created_at y, para Alias, elija resolution_time.

3. Agregue un nuevo campo a partir de la transformación del cálculo: para Modo, seleccione Operación binaria, para Operación, seleccione resolution_time/86400000 y, para Alias, elija resolution_time.

   En Reemplazar todos los campos, elija Verdadero.

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

   • Mostrar = Calcular

   • Cálculo = media

   • Campos = resolution_time