As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Conecte-se a uma fonte GitLab de dados
A fonte de GitLab dados permite que você acompanhe GitLab estatísticas detalhadas, como principais colaboradores, confirmações por dia ou implantações por dia. Você também pode usar variáveis de modelo, como projetos, para configurar filtros para os dashboards. Você pode combinar dados da GitLab API com dados de outras fontes.
**nota**
Essa fonte de dados é somente para o Grafana Enterprise. Para obter mais informações, consulte [Gerenciar o acesso aos plug-ins do Enterprise](upgrade-to-enterprise-plugins.md).
Além disso, em espaços de trabalho compatíveis com a versão 9 ou mais recente, essa fonte de dados pode requerer a instalação do plug-in apropriado. Para obter mais informações, consulte [Ampliar o espaço de trabalho com plug-ins](grafana-plugins.md).
## Limitações conhecidas
O alerta ainda não é compatível com esse plug-in porque as transformações não são suportadas nas consultas de alertas e as transformações são a única maneira de obter métricas agregadas significativas dos dados brutos da API. GitLab
## Adicionar a fonte de dados
1. Abra o console do Grafana no espaço de trabalho do Amazon Managed Grafana e verifique se está logado.
1. No menu lateral, em **Configuração** (o ícone de engrenagem), escolha **Fontes de dados**.
1. Escolha **Adicionar fonte de dados**.
**nota**
Se você não vir o link **Fontes de dados** no menu lateral, isso significa que seu usuário atual não tem o perfil de `Admin`.
1. Selecione na **GitLab**lista de fontes de dados.
1. Insira as seguintes informações:
+ Em **Nome**, insira um nome para essa fonte GitLab de dados.
+ Em **URL**, insira o URL raiz da sua GitLab instância, como**https://gitlab.com/api/v4**.
+ Em **Token de acesso**, insira seu token de acesso GitLab pessoal.
## Consulte a fonte GitLab de dados
No Editor de GitLab consultas, você pode selecionar diferentes tipos de recursos, como confirmações, problemas ou versões.
**Filtrar e visualizar projetos**
1. No menu suspenso, escolha **Projetos**.
1. (Opcional) Filtre pelos projetos que você possui.
1. Use o menu suspenso e selecione **Sim** ou **Não** para filtrar os resultados.
**nota**
Buscar todos os projetos **Propriedade = Não** pode levar muito tempo.
**Filtrar e visualizar confirmações**
1. No menu suspenso, escolha **Confirmações**.
1. Use o campo de entrada para adicionar o ID do projeto.
1. (Opcional) Para filtrar, branch/tag use o campo de entrada para adicionar uma branch/tag referência.
**Filtrar e visualizar problemas**
1. No menu suspenso, escolha **Problemas**.
1. Use o campo de entrada para adicionar o ID do projeto.
1. (Opcional) Para filtrar por título e descrição, use o campo de entrada para pesquisar problemas com base no **título** e na **descrição**.
**Visualizar versões**
1. No menu suspenso, escolha **Implantações**.
1. Use o campo de entrada para adicionar o ID do projeto.
1. (Opcional) Para filtrar por ambiente e status, use os campos de entrada. O atributo de **status** pode ser um dos seguintes valores: `created`, `running`, `success`, `failed` ou `canceled`.
**Visualizar rótulos**
1. No menu suspenso, escolha **Rótulos**.
1. Use o campo de entrada para adicionar o ID do projeto.
## Modelos e variáveis
Para adicionar uma nova variável de GitLab consulta, consulte[Adicionar uma variável de consulta.](variables-types.md#add-a-query-variable). Use sua fonte de GitLab dados como fonte de dados. Escolha um tipo de recurso: **Versões**, **Projetos** ou **Rótulos**.
Para obter uma lista dinâmica de projetos, rótulos etc. da qual escolher, crie uma variável de tipo de consulta. As variáveis do tipo de GitLab consulta usam o Editor de consultas para consultar e retornar projetos, rótulos e assim por diante. O exemplo a seguir cria uma variável de projeto para parametrizar suas consultas
**Criar uma variável de projeto para parametrizar suas consultas**
1. Adicione uma variável do tipo **Consulta** denominada **project**.
1. Selecione sua fonte GitLab de dados e atualize **On Dashboard Load**.
1. Selecione o tipo de recurso **Projetos**, **Sim** para **Propriedade**, **nome** para **campo de exibição** e **ID** para **campo de valor**.
1. Escolha **Atualizar** para adicionar a variável ao dashboard.
1. Adicione um novo painel ao dashboard e use **\$1project** como o ID do projeto.
Agora, ao escolher no menu suspenso, você obtém os resultados que pertencem a esse projeto.
## Usar as transformações do Grafana para responder a perguntas comuns
Agora que você pode realizar GitLab consultas básicas para encontrar confirmações, problemas etc., você pode usar Transformações para visualizar, agregar, agrupar e unir conjuntos de dados, junto com muitos outros tipos de transformações para transformar resultados simples em respostas para perguntas complexas. Abaixo estão algumas perguntas comuns e como usar as transformações para respondê-las.
**Quantos commits/issues/deployments por dia no meu projeto?**
1. Adicione uma consulta. Selecione **Confirmações** para o tipo de recurso e adicione o ID do projeto.
1. Adicione uma nova transformação de **Agrupar por**: em **Agrupar por**, selecione **created\$1at\$1date** e, em seguida, calcule **(Count)=id**
1. Escolha a visualização **Grafo**.
**Qual é o tempo médio para resolver problemas no meu projeto?**
1. Adicione uma consulta. Selecione **Problemas** para o tipo de recurso e adicione o ID do projeto.
1. Adicione uma nova transformação de **Adicionar campo do cálculo**: em **Modo**, selecione **Operação binária**, em **Operação**, selecione **closed\$1at = created\$1at** e, em **Alias**, escolha **resolution\$1time**.
1. Adicione uma nova transformação de **Adicionar campo do cálculo**: em **Modo**, selecione **Operação binária**, em **Operação**, selecione **resolution\$1time / 86400000** e, em **Alias**, escolha **resolution\$1time**.
Em **Substituir todos os campos**, escolha **True**.
1. Escolha a visualização **Estatística**.
+ Mostrar = Calcular
+ Cálculo = Média
+ Campos = **resolution\$1time**