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.
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 los datos de la GitLab API con datos de otras fuentes.
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 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.
Adición del origen de datos
-
Abra la consola de Grafana en el espacio de trabajo de Amazon Managed Grafana y asegúrese de haber iniciado sesión.
-
En el menú lateral, en Configuración (el icono con forma de engranaje), seleccione Orígenes de datos.
-
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. -
Seleccione una GitLabde las fuentes de datos de la lista.
-
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 ejemplo
https://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.
Filtro y visualización de proyectos
-
En el menú desplegable, seleccione Proyectos.
-
(Opcional) Filtre por los proyectos que son de su propiedad.
-
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
-
En el menú desplegable, seleccione Confirmaciones.
-
Use el campo de entrada para agregar el ID del proyecto.
-
(Opcional) Para filtrar por branch/tag use the input field to add a branch/tag referencia.
Filtrado y visualización de problemas
-
En el menú desplegable, seleccione Problemas.
-
Use el campo de entrada para agregar el ID del proyecto.
-
(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
-
En el menú desplegable, selecciona Implementaciones.
-
Use el campo de entrada para agregar el ID del proyecto.
-
(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,failedocanceled.
Visualización de etiquetas
-
En el menú desplegable, seleccione Etiquetas.
-
Use el campo de entrada para agregar el ID del proyecto.
Plantillas y variables
Para añadir una nueva variable de GitLab consulta, consulteAdición de 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 de 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
Creación de una variable de proyecto para parametrizar las consultas
-
Agregue una variable de tipo Consulta denominada
project. -
Seleccione la fuente GitLab de datos y actualice On Dashboard Load.
-
Seleccione el tipo de recurso Proyecto, Sí para Propio, nombre para campo de visualización e id para el campo de valor.
-
Seleccione Actualizar para agregar la variable al panel.
-
Agregue un panel nuevo al panel y use
$projectcomo 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 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 se explica cómo usar las transformaciones para responderlas.
¿Cuántos hay commits/issues/deployments por día en mi proyecto?
-
Agregue una consulta. Seleccione Confirmaciones para el tipo de recurso y agregue el ID del proyecto.
-
Agregue una nueva transformación Agrupar por: en Agrupar por, seleccione created_at_date y, a continuación, calcule (Count)=id
-
Elija la visualización Gráfico.
¿Cuál es el tiempo promedio que se tarda en cerrar los problemas de mi proyecto?
-
Agregue una consulta. Seleccione Problemas para el tipo de recurso y agregue el ID del proyecto.
-
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.
-
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.
-
Elija la visualización Estadísticas.
-
Mostrar = Calcular
-
Cálculo = Media
-
Campos = resolution_time
-
