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á.
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.
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.
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
-
Abra o console do Grafana no espaço de trabalho do Amazon Managed Grafana e verifique se está logado.
-
No menu lateral, em Configuração (o ícone de engrenagem), escolha Fontes de dados.
-
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. -
Selecione na GitLablista de fontes de dados.
-
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
-
No menu suspenso, escolha Projetos.
-
(Opcional) Filtre pelos projetos que você possui.
-
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
-
No menu suspenso, escolha Confirmações.
-
Use o campo de entrada para adicionar o ID do projeto.
-
(Opcional) Para filtrar por branch/tag use the input field to add a branch/tag referência.
Filtrar e visualizar problemas
-
No menu suspenso, escolha Problemas.
-
Use o campo de entrada para adicionar o ID do projeto.
-
(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
-
No menu suspenso, escolha Implantações.
-
Use o campo de entrada para adicionar o ID do projeto.
-
(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,failedoucanceled.
Visualizar rótulos
-
No menu suspenso, escolha Rótulos.
-
Use o campo de entrada para adicionar o ID do projeto.
Modelos e variáveis
Para adicionar uma nova variável de GitLab consulta, consulteAdicionar uma variável de consulta.. 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
-
Adicione uma variável do tipo Consulta denominada
project. -
Selecione sua fonte GitLab de dados e atualize On Dashboard Load.
-
Selecione o tipo de recurso Projetos, Sim para Propriedade, nome para campo de exibição e ID para campo de valor.
-
Escolha Atualizar para adicionar a variável ao dashboard.
-
Adicione um novo painel ao dashboard e use
$projectcomo 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?
-
Adicione uma consulta. Selecione Confirmações para o tipo de recurso e adicione o ID do projeto.
-
Adicione uma nova transformação de Agrupar por: em Agrupar por, selecione created_at_date e, em seguida, calcule (Count)=id
-
Escolha a visualização Grafo.
Qual é o tempo médio para resolver problemas no meu projeto?
-
Adicione uma consulta. Selecione Problemas para o tipo de recurso e adicione o ID do projeto.
-
Adicione uma nova transformação de Adicionar campo do cálculo: em Modo, selecione Operação binária, em Operação, selecione closed_at = created_at e, em Alias, escolha resolution_time.
-
Adicione uma nova transformação de Adicionar campo do cálculo: em Modo, selecione Operação binária, em Operação, selecione resolution_time / 86400000 e, em Alias, escolha resolution_time.
Em Substituir todos os campos, escolha True.
-
Escolha a visualização Estatística.
-
Mostrar = Calcular
-
Cálculo = Média
-
Campos = resolution_time
-
