Conexión a un origen de datos de GitLab - Amazon Managed Grafana
Limitaciones conocidasAdición del origen de datosConsulta del origen de datos de GitLabPlantillas y variablesUso de transformaciones de Grafana para responder a preguntas comunes

Conexión a un origen de datos de GitLab

El origen de datos de GitLab datos le permite hacer un seguimiento de estadísticas detalladas de GitLab, como los principales colaboradores, 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 API de GitLab con datos de otros orígenes.

nota

Este origen de datos es solo para Grafana Enterprise. Para obtener más información, consulte Administración del acceso a los complementos empresariales.

Además, en los espacios de trabajo compatibles con la versión 9 o posterior, es posible que se deba instalar el complemento adecuado para este origen de datos. Para obtener más información, consulte Ampliación de su espacio de trabajo con complementos.

Limitaciones conocidas

Este complemento aún no admite 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 API de GitLab.

Adición del origen de datos

  1. Abra la consola de Grafana en el espacio de trabajo de Amazon Managed Grafana y asegúrese de haber iniciado sesión.

  2. En el menú lateral, en Configuración (el icono con forma de engranaje), seleccione Orígenes de datos.

  3. Elija Agregar origen de datos.

    nota

    Si no ve el enlace Orígenes de datos en el menú lateral, su usuario actual no tiene el rol Admin.

  4. Seleccione GitLab de la lista de orígenes de datos.

  5. Introduzca la información siguiente:

    • En Nombre, ingrese un nombre para este origen de datos de GitLab.

    • En URL, ingrese la URL raíz de la instancia de GitLab, por ejemplo, https://gitlab.com/api/v4.

    • En Token de acceso, ingrese su token de acceso personal de GitLab.

Consulta del origen de datos de GitLab

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

Filtro y visualización de proyectos

  1. En el menú desplegable, seleccione Proyectos.

  2. (Opcional) Filtre por los proyectos que son de su propiedad.

  3. Use el menú desplegable y seleccione Sí o No para filtrar los resultados.

    nota

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

Filtro y visualización de confirmaciones

  1. En el menú desplegable, seleccione Confirmaciones.

  2. Use el campo de entrada para agregar el ID del proyecto.

  3. (Opcional) Para filtrar por ramificación o etiqueta, use el campo de entrada para agregar una referencia de ramificación o etiqueta.

Filtrado y visualización de problemas

  1. En el menú desplegable, seleccione Problemas.

  2. Use el campo de entrada para agregar el ID del proyecto.

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

Visualización de versiones

  1. En el menú desplegable, selecciona Implementaciones.

  2. Use el campo de entrada para agregar el ID del proyecto.

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

Visualización de etiquetas

  1. En el menú desplegable, seleccione Etiquetas.

  2. Use el campo de entrada para agregar el ID del proyecto.

Plantillas y variables

Para agregar una nueva variable de consulta de GitLab, consulte Adición de una variable de consulta. Utilice su origen de datos de GitLab como origen 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 consulta usan el editor de consultas de GitLab para consultar y devolver proyectos, etiquetas, etc. En el siguiente ejemplo, se crea una variable de proyecto para parametrizar las consultas

Creación de una variable de proyecto para parametrizar las consultas

  1. Agregue una variable de tipo Consulta denominada project.

  2. Seleccione su origen de datos de GitLab y actualice Al cargar el panel.

  3. Seleccione el tipo de recurso Proyecto, Sí para Propio, nombre para campo de visualización e id para el campo de valor.

  4. Seleccione Actualizar para agregar la variable al panel.

  5. Agregue un panel nuevo al panel y use $project como ID del proyecto.

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

Uso de transformaciones de Grafana para responder a preguntas comunes

Ahora que puede hacer consultas de GitLab 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 se explica cómo usar las transformaciones para responderlas.

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

  1. Agregue una consulta. Seleccione Confirmaciones para el tipo de recurso y agregue el ID del proyecto.

  2. Agregue una nueva transformación Agrupar por: en Agrupar por, seleccione created_at_date y, a continuación, calcule (Count)=id

  3. Elija la visualización Gráfico.

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

  1. Agregue una consulta. Seleccione Problemas para el tipo de recurso y agregue el ID del proyecto.

  2. Agregue una nueva transformación Agregar campo a partir del cálculo: en Modo, seleccione Operación binaria; en Operación, seleccione closed_at = created_at; y en Alias, elija resolution_time.

  3. Agregue una nueva transformación Agregar campo a partir del cálculo: en Modo, seleccione Operación binaria; en Operación, seleccione resolution_time / 86400000; y en Alias, elija resolution_time.

    En Sustituir todos los campos, elija Verdadero.

  4. Elija la visualización Estadísticas.

    • Mostrar = Calcular

    • Cálculo = Media

    • Campos = resolution_time