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.
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íodo | Descrição |
---|---|
Semana atual (seg-dom) | Dados de segunda-feira até o dia atual em que a página é visualizada. |
Mês atual | Dados do primeiro dia do mês até o dia atual em que a página é visualizada. |
Mês passado | Dados do primeiro ao último dia do mês anterior. |
Últimos 30 dias | Dados dos últimos 30 dias até quando a página é visualizada. |
Últimos 90 dias | Dados dos últimos 90 dias até quando a página é visualizada. |
Último ano | Dados agregados dos últimos 12 meses. |
Personalizado | Dados de um intervalo de datas personalizado. O intervalo pode ser de até 100 dias, incluindo as datas de início e término, e voltar até um ano. |
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.
-
No canto superior direito de GitHub, selecione sua foto de perfil e selecione Suas organizações.
-
Clique no nome da sua organização.
-
Sob o nome da organização, clique em Insights.
-
No menu de navegação “Insights”, selecione Métricas de Uso do Actions ou Métricas de Desempenho do Actions.
-
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”.
-
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”.
-
Opcionalmente, para filtrar os dados exibidos em uma guia, crie um filtro.
- Clique no botão Filtro.
- Clique em Adicionar um filtro.
- Escolha uma métrica pela qual você gostaria de filtrar os resultados.
- Dependendo da métrica escolhida, preencha as informações nas colunas "Qualificador", "Operador" e "Valor".
- Opcionalmente, clique em Adicionar um filtro para adicionar outro filtro.
- Clique em Aplicar.
-
Opcionalmente, para baixar métricas de uso para um arquivo CSV, clique em .
Como ver as métricas do GitHub Actions do seu repositório
Note
As métricas no repositório do GitHub Actions estão em versão prévia pública e sujeitas a alterações.
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.
- Em GitHub, acesse a página principal do repositório.
- Abaixo do nome do repositório, selecione a guia Insights.
- No menu de navegação “Insights”, selecione Métricas de Uso do Actions ou Métricas de Desempenho do Actions.
- 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”.
- 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”.
- Opcionalmente, para filtrar os dados exibidos em uma guia, crie um filtro.
- Clique no botão Filtro.
- Clique em Adicionar um filtro.
- Escolha uma métrica pela qual você gostaria de filtrar os resultados.
- Dependendo da métrica escolhida, preencha as informações nas colunas "Qualificador", "Operador" e "Valor".
- Opcionalmente, clique em Adicionar um filtro para adicionar outro filtro.
- Clique em Aplicar.
- Opcionalmente, para baixar métricas de uso para um arquivo CSV, clique em .