Skip to main content

Viewing GitHub Actions metrics

You can view metrics to monitor where your organization or repositories use GitHub Actions and how they are performing.

Quem pode usar esse recurso?

Organization owners and users with the "View organization Actions metrics" permission can view organization-level metrics.

Users with the base repository role can view repository-level metrics.

About GitHub Actions metrics

GitHub Actions metrics provide insights into how your workflows and jobs are performing at the organization and repository levels. There are two types of metrics to help you analyze different aspects of your workflows:

  • GitHub Actions usage metrics: Usage metrics help you track how many minutes your workflows and jobs consume. You can use this data to understand the cost of running Actions and ensure you're staying within your plan limits. This is especially useful for identifying high-usage workflows or repositories.
  • GitHub Actions performance metrics: Performance metrics focus on the efficiency and reliability of your workflows and jobs. With performance metrics, you can monitor key indicators like job run times, queue times, and failure rates to identify bottlenecks, slow-running jobs, or frequently failing workflows.

Enabling access to GitHub Actions metrics

Organization owners can create custom organization roles to allow people to view GitHub Actions usage metrics for their organization. To provide users with access, select the "View organization Actions metrics" role when creating a custom organization role. For more information, see "Sobre as funções da organização personalizadas."

About GitHub Actions usage metrics

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.

About GitHub Actions performance metrics

Note

GitHub Actions performance metrics is currently in versão prévia pública and subject to change.

GitHub Actions performance metrics enables you to analyze the efficiency and reliability of your workflows. You can view performance information such as average run times, average queue times, and failure rates, related to:

  • Workflows. View performance data for each workflow in your organization, including average run time and job failures. Use this information to identify inefficient workflows and run stability.
  • Jobs. View performance data for each individual job to, including average run time, average queue time, and job failures. Use this information to identify inefficient jobs.
  • Repositories. Get a high-level snapshot of each repository in your organization and their average performance metrics.
  • Runtime OS. Understand how runners for each operating system are performing.
  • Runner type. Compare the performance of self-hosted runners and GitHub-hosted runners, to make decisions about runner types.

Understanding GitHub Actions metrics aggregation

O recurso de seleção de período de tempo permite que você visualize métricas de uso 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.

Viewing GitHub Actions metrics for your organization

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. In the "Insights" navigation menu, click Actions Usage Metrics or click Actions Performance Metrics.

  5. Optionally, to select a time period to view usage metrics for, choose an option from the Period drop down menu at the top right of the page. For more information, see "Understanding GitHub Actions metrics aggregation."

  6. Click on the tab that contains the metrics you would like to view. For more information, see "About GitHub Actions usage metrics or "About GitHub Actions performance metrics."

  7. Optionally, to filter the data displayed in a tab, create a filter.

    1. Click on the Filter button.
    2. Click Add a filter.
    3. Choose a metric you would like to filter results by.
    4. Depending on the metric you chose, fill out information in the "Qualifier," "Operator," and "Value" columns.
    5. Optionally, click Add a filter to add another filter.
    6. Click Apply.
  8. Optionally, to download usage metrics to a CSV file, click .

Viewing GitHub Actions metrics for your repository

Note

Repository-level metrics for GitHub Actions is in versão prévia pública and subject to change.

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. Em GitHub, acesse a página principal do repositório.
  2. Under your repository name, click the Insights tab.
  3. In the "Insights" navigation menu, click Actions Usage Metrics or click Actions Performance Metrics.
  4. Optionally, to select a time period to view usage metrics for, choose an option from the Period drop down menu at the top right of the page. For more information, see "Understanding GitHub Actions metrics aggregation."
  5. Click on the tab that contains the metrics you would like to view. For more information, see "About GitHub Actions usage metrics or "About GitHub Actions performance metrics."
  6. Optionally, to filter the data displayed in a tab, create a filter.
    1. Click on the Filter button.
    2. Click Add a filter.
    3. Choose a metric you would like to filter results by.
    4. Depending on the metric you chose, fill out information in the "Qualifier," "Operator," and "Value" columns.
    5. Optionally, click Add a filter to add another filter.
    6. Click Apply.
  7. Optionally, to download usage metrics to a CSV file, click .