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
<a name="gitlab-AMG-datasource"></a>

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](upgrade-to-enterprise-plugins.md).  
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](grafana-plugins.md).

## Limitaciones conocidas
<a name="gitlab-known-limitations"></a>

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
<a name="gitlab-adding-the-data-source"></a>

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

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

1.  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`. 

1.  Seleccione una **GitLab**de las fuentes de datos de la lista. 

1. 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**.
   + Para el **token de acceso**, introduce tu token de acceso GitLab personal.

## Consulte la fuente GitLab de datos
<a name="gitlab-query"></a>

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

**Filtro y visualización de proyectos**

1.  En el menú desplegable, seleccione **Proyectos**. 

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

1.  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**. 

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

1.  (Opcional) Para filtrar por, branch/tag usa el campo de entrada para agregar una branch/tag referencia. 

**Filtrado y visualización de problemas**

1.  En el menú desplegable, seleccione **Problemas**. 

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

1.  (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**. 

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

1.  (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**. 

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

## Plantillas y variables
<a name="gitlab-templates"></a>

Para añadir una nueva variable de GitLab consulta, consulte[Adición de una variable de consulta](variables-types.md#add-a-query-variable). 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**

1.  Agregue una variable de tipo **Consulta** denominada **project**. 

1.  Seleccione la fuente GitLab de datos y actualice **On Dashboard Load**. 

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

1. Seleccione **Actualizar** para agregar la variable al panel.

1. Agregue un panel nuevo al panel y use **\$1project** 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
<a name="gitlab-transformations"></a>

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?**

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

1.  Agregue una nueva transformación **Agrupar por**: en **Agrupar por**, seleccione **created\$1at\$1date** y, a continuación, calcule **(Count)=id** 

1. 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. 

1.  Agregue una nueva transformación **Agregar campo a partir del cálculo**: en **Modo**, seleccione **Operación binaria**; en **Operación**, seleccione **closed\$1at = created\$1at**; y en **Alias**, elija **resolution\$1time**. 

1.  Agregue una nueva transformación **Agregar campo a partir del cálculo**: en **Modo**, seleccione **Operación binaria**; en **Operación**, seleccione **resolution\$1time / 86400000**; y en **Alias**, elija **resolution\$1time**. 

   En **Sustituir todos los campos**, elija **Verdadero**.

1. Elija la visualización **Estadísticas**.
   + Mostrar = Calcular
   + Cálculo = Media
   + Campos = **resolution\$1time**