Skip to main content

Como ver as métricas do GitHub Actions da sua organização

As métricas do GitHub Actions trazem insights sobre como e onde sua organização está usando os recursos para os pipelines de CI/CD.

Quem pode usar esse recurso?

Organization owners and users with the "View organization Actions metrics" permission.

Sobre as métricas do GitHub Actions

As métricas do GitHub Actions trazem insights sobre o desempenho dos seus fluxos de trabalho e trabalhos na organização e no repositório. Há dois tipos de métricas para ajudar você a analisar diferentes aspectos dos seus fluxos de trabalho:

  • Métricas de uso do GitHub Actions: as métricas de uso ajudam a acompanhar os minutos consumidos pelos seus fluxos de trabalho e trabalhos. Você pode usar esses dados para entender como funciona o custo de execução do Actions e garantir que esteja dentro dos limites do seu plano. Isso é especialmente útil para identificar fluxos de trabalho ou repositórios de alto uso.
  • Métricas de desempenho do GitHub Actions: as métricas de desempenho têm como foco a eficiência e a confiabilidade dos seus trabalhos e fluxos de trabalho. Com as métricas de desempenho, você pode monitorar indicadores importantes, como tempos de execução de trabalho, tempos de fila e taxas de falha para identificar gargalos, trabalhos de execução lenta ou fluxos de trabalho com falha frequente.

Como habilitar o acesso a métricas do GitHub Actions

Os proprietários da organização podem criar funções de organização personalizadas para permitir que as pessoas exibam métricas de uso do GitHub Actions para suas organizações. Para fornecer acesso aos usuários, escolha a função “Exibir métricas do Actions da organização” ao criar uma função de organização personalizada. Para obter mais informações, confira "Sobre as funções da organização personalizadas".

Sobre métricas de uso do GitHub Actions

As métricas de uso de GitHub Actions permitem que você analise como sua organização está usando os minutos do Actions. Você pode exibir informações de uso relacionadas a:

  • Fluxos de trabalho. Exiba dados de uso para cada fluxo de trabalho em sua organização e use essas informações para identificar oportunidades de otimização, como refatoração de um fluxo de trabalho ou uso de um executor maior.
  • Trabalhos. Veja quais trabalhos consomem mais recursos e onde estão sendo executados.
  • Repositórios. Obtenha um instantâneo de alto nível de cada repositório em sua organização e seu volume de uso de minutos do Actions.
  • SO do runtime. Entenda como os executores de cada sistema operacional estão usando os minutos do Actions e em quais tipos de sistemas operacionais seus fluxos de trabalho estão sendo executados com mais frequência.
  • Tipo de executor. Compare como seus executores auto-hospedados e os executores hospedados no GitHub usam os minutos do Actions e o volume de execuções do fluxo de trabalho para cada tipo de executor.

As métricas de uso GitHub Actions não aplicam multiplicadores de minutos às métricas exibidas. Embora possam ajudar você a entender sua fatura, seu objetivo principal é ajudar você a entender como e onde os minutos do Actions estão sendo usados em sua organização.

Para obter mais informações sobre os multiplicadores de minutos, confira "Sobre a cobrança das GitHub Actions".

Sobre as métricas de desempenho do GitHub Actions

Note

Atualmente, as métricas de desempenho do GitHub Actions estão em versão prévia pública e sujeitas a alterações.

As métricas de desempenho do GitHub Actions permitem que você analise a eficiência e a confiabilidade dos seus fluxos de trabalho. Você pode ver informações de desempenho, como tempos médios de execução, tempos médios de fila e taxas de falha, relacionadas a:

  • Fluxos de trabalho. Veja dados de desempenho para cada fluxo de trabalho da sua organização, incluindo tempo médio de execução e falhas de trabalho. Use essas informações para identificar fluxos de trabalho ineficientes e a estabilidade da execução.
  • Trabalhos. Veja dados de desempenho de cada trabalho individual, incluindo tempo médio de execução, tempo médio de fila e falhas de trabalho. Use essas informações para identificar trabalhos ineficientes.
  • Repositórios. Obtenha um snapshot de alto nível de cada repositório da sua organização e as métricas de desempenho médio.
  • SO do runtime. Entenda como está o desempenho dos executores de cada sistema operacional.
  • Tipo de executor. Compare o desempenho de executores auto-hospedados e dos executores hospedados no GitHub para tomar decisões sobre os tipos de executores.

Noções básicas sobre a agregação de métricas do GitHub Actions

O recurso de seleção de período permite que você veja as métricas do GitHub Actions em períodos predefinidos, conforme detalhado na tabela a seguir. Essas métricas incluem execuções ignoradas e aquelas que usam zero minutos. Os dados são apresentados usando dias em Tempo Universal Coordenado (UTC).

PeríodoDescrição
Semana atual (seg-dom)Dados de segunda-feira até o dia atual em que a página é visualizada.
Mês atualDados do primeiro dia do mês até o dia atual em que a página é visualizada.
Mês passadoDados do primeiro ao último dia do mês anterior.
Últimos 30 diasDados dos últimos 30 dias até quando a página é visualizada.
Últimos 90 diasDados dos últimos 90 dias até quando a página é visualizada.
Último anoDados agregados dos últimos 12 meses.

Como ver as métricas do GitHub Actions da sua organização

Note

Pode haver uma discrepância entre a contagem de trabalhos da guia Fluxos de Trabalho e a contagem da guia Trabalhos devido a diferenças em como os trabalhos únicos são identificados. Isso não afeta o total de minutos calculados.

  1. No canto superior direito de GitHub, selecione sua foto de perfil e selecione Suas organizações.

  2. Clique no nome da sua organização.

  3. Sob o nome da organização, clique em Insights.

    Captura de tela da barra de navegação horizontal para uma organização. Uma guia, rotulada com um ícone de grafo e "Insights" tem um contorno laranja escuro.

  4. No menu de navegação “Insights”, selecione Métricas de Uso do Actions ou Métricas de Desempenho do Actions.

  5. Opcionalmente, para selecionar um período de tempo para exibir as métricas de uso, escolha uma opção no menu suspenso Período no canto superior direito da página. Para mais informações, confira “Noções básicas sobre a agregação de métricas do GitHub Actions”.

  6. Selecione a guia que contém as métricas que deseja ver. Para obter mais informações, confira “Sobre as métricas de uso do GitHub Actions” ou “Sobre as métricas de desempenho do GitHub Actions”.

  7. Opcionalmente, para filtrar os dados exibidos em uma guia, crie um filtro.

    1. Clique no botão Filtro.
    2. Clique em Adicionar um filtro.
    3. Escolha uma métrica pela qual você gostaria de filtrar os resultados.
    4. Dependendo da métrica escolhida, preencha as informações nas colunas "Qualificador", "Operador" e "Valor".
    5. Opcionalmente, clique em Adicionar um filtro para adicionar outro filtro.
    6. Clique em Aplicar.
  8. Opcionalmente, para baixar métricas de uso para um arquivo CSV, clique em .