Conectar-se a uma fonte de dados GitLab - Amazon Managed Grafana
Limitações conhecidasAdicionar a fonte de dadosConsultar a fonte de dados GitLabModelos e variáveisUsar as transformações do Grafana para responder a perguntas comuns

Conectar-se a uma fonte de dados GitLab

A fonte de dados GitLab permite que você acompanhe estatísticas detalhadas do GitLab, como os principais colaboradores, as confirmações por dia ou as 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 API GitLab 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

Os alertas ainda não são compatíveis com este plug-in porque as transformações não são compatíveis com as 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.

  2. No menu lateral, em Configuração (o ícone de engrenagem), escolha Fontes de dados.

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

  4. Selecione GitLab na lista de fontes de dados.

  5. Insira as seguintes informações:

    • Em Nome, insira um nome para essa fonte de dados GitLab.

    • Em URL, insira o URL raiz da instância do GitLab, como https://gitlab.com/api/v4.

    • Em Token de acesso, insira o token de acesso pessoal do GitLab.

Consultar a fonte de dados GitLab

No Editor de Consultas do GitLab, você pode selecionar diferentes tipos de recursos, como confirmações, problemas ou lançamentos.

Filtrar e visualizar projetos

  1. No menu suspenso, escolha Projetos.

  2. (Opcional) Filtre pelos projetos que você possui.

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

  2. Use o campo de entrada para adicionar o ID do projeto.

  3. (Opcional) Para filtrar por ramificação e tag, use o campo de entrada para adicionar uma referência de ramificação e tag.

Filtrar e visualizar problemas

  1. No menu suspenso, escolha Problemas.

  2. Use o campo de entrada para adicionar o ID do projeto.

  3. (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.

  2. Use o campo de entrada para adicionar o ID do projeto.

  3. (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.

  2. Use o campo de entrada para adicionar o ID do projeto.

Modelos e variáveis

Para adicionar uma nova variável de consulta do GitLab, consulte Adicionar uma variável de consulta.. Use sua fonte de dados GitLab como a 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 consulta usam o Editor de Consultas do GitLab para consultar e retornar projetos, rótulos etc. 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.

  2. Selecione a fonte de dados GitLab e atualize No carregamento do dashboard.

  3. Selecione o tipo de recurso Projetos, Sim para Propriedade, nome para campo de exibição e ID para campo de valor.

  4. Escolha Atualizar para adicionar a variável ao dashboard.

  5. Adicione um novo painel ao dashboard e use $project 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 consultas básicas do GitLab 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.

Quantas confirmações, problemas e implantações por dia no meu projeto?

  1. Adicione uma consulta. Selecione Confirmações para o tipo de recurso e adicione o ID do projeto.

  2. Adicione uma nova transformação de Agrupar por: em Agrupar por, selecione created_at_date e, em seguida, calcule (Count)=id

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

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

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

  4. Escolha a visualização Estatística.

    • Mostrar = Calcular

    • Cálculo = Média

    • Campos = resolution_time