{"meta":{"title":"Usando registros de execução de fluxo de trabalho","intro":"Você pode visualizar, pesquisar e fazer download dos logs para cada trabalho em uma execução de fluxo de trabalho.","product":"GitHub Actions","breadcrumbs":[{"href":"/pt/enterprise-server@3.18/actions","title":"GitHub Actions"},{"href":"/pt/enterprise-server@3.18/actions/how-tos","title":"Instruções"},{"href":"/pt/enterprise-server@3.18/actions/how-tos/monitor-workflows","title":"Monitorar fluxos de trabalho"},{"href":"/pt/enterprise-server@3.18/actions/how-tos/monitor-workflows/use-workflow-run-logs","title":"Utilizar registros de execução de fluxo de trabalho"}],"documentType":"article"},"body":"# Usando registros de execução de fluxo de trabalho\n\nVocê pode visualizar, pesquisar e fazer download dos logs para cada trabalho em uma execução de fluxo de trabalho.\n\n> \\[!NOTE]\n> No momento, não há suporte para executores hospedados no GitHub Enterprise Server no GitHub.\n\nNa página de execução de fluxo de trabalho, você pode verificar se a execução está em andamento ou foi concluída. Você deve estar conectado a uma GitHub conta para exibir informações de execução de fluxo de trabalho, inclusive para repositórios públicos. Para saber mais, confira [Permissões de acesso no GitHub](/pt/enterprise-server@3.18/get-started/learning-about-github/access-permissions-on-github).\n\nSe a execução estiver concluída, será possível ver se o resultado teve êxito, se houve falha, se foi cancelado ou se ficou neutro. Em caso de falha, você poderá exibir e pesquisar os logs de criação para diagnosticar a falha e executar o fluxo de trabalho novamente. Você também pode visualizar os minutos da execução do trabalho faturável ou fazer o download dos registros e criar artefatos.\n\nGitHub Actions use a API de Verificações para gerar status, resultados e logs para um fluxo de trabalho.\nGitHub cria um novo conjunto de verificações para cada execução de fluxo de trabalho. O conjunto de verificações contêm uma execução de verificação para cada trabalho no fluxo de trabalho, e cada trabalho inclui etapas.\nGitHub Actions são executados como uma etapa em um fluxo de trabalho. Para saber mais sobre a API de Verificações, confira [Pontos de extremidade da API REST para verificações](/pt/enterprise-server@3.18/rest/checks).\n\n> \\[!NOTE]\n> Faça commit apenas de arquivos de fluxo de trabalho válidos em seu repositório. Se `.github/workflows` contiver um arquivo de fluxo de trabalho inválido, GitHub Actions gerará uma execução de fluxo de trabalho com falha para cada nova confirmação.\n\n## Exibir logs para diagnosticar falhas\n\nSe houver falha na execução do fluxo de trabalho, você poderá ver qual etapa causou a falha e revisar os logs de criação da etapa com falha para resolver os problemas. Também é possível ver a duração da execução de cada etapa. Além disso, você pode copiar um permalink para determinada linha no arquivo de log a fim de compartilhar com a sua equipe. É necessário o acesso de leitura ao repositório é para executar essas etapas.\n\nAlém das etapas configuradas no arquivo de fluxo de trabalho, GitHub adiciona duas etapas adicionais a cada trabalho para configurar e concluir a execução do trabalho. Estas etapas estão registradas na execução do fluxo de trabalho com os nomes \"Configurar trabalho\" e \"Concluir trabalho\".\n\nPara trabalhos executados em executores hospedados no GitHub, \"Configurar trabalho\" registra os detalhes da imagem do executor e inclui um link para a lista de ferramentas pré-instaladas que estavam presentes na máquina do executor.\n\n1. Em GitHub, acesse a página principal do repositório.\n2. No nome do repositório, clique em ** Actions**.\n\n \n3. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver.\n\n \n4. Na lista de execuções de fluxo de trabalho, clique no nome da execução para ver o resumo da execução do fluxo de trabalho.\n5. Em **Trabalhos** ou no grafo de visualização, clique no trabalho que deseja ver.\n6. Todas as etapas com falha são automaticamente expandidas para exibir os resultados.\n7. Para obter um link para uma linha específica nos logs, clique no número da linha da etapa. Em seguida, você pode copiar o link da barra de endereço do seu navegador da web.\n\n \n\n## Pesquisar registros\n\nÉ possível pesquisar os logs de criação em determinadas etapas. Quando você pesquisa os logs, somente as etapas expandidas são incluídas nos resultados. É necessário o acesso de leitura ao repositório é para executar essas etapas.\n\n1. Em GitHub, acesse a página principal do repositório.\n2. No nome do repositório, clique em ** Actions**.\n\n \n3. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver.\n\n \n4. Na lista de execuções de fluxo de trabalho, clique no nome da execução para ver o resumo da execução do fluxo de trabalho.\n5. Em **Trabalhos** ou no grafo de visualização, clique no trabalho que deseja ver.\n6. No canto superior direito da saída do log, na caixa de pesquisa **Pesquisar logs**, digite uma consulta de pesquisa.\n\n## Baixar registros\n\nVocê pode fazer o download dos arquivos de registro da execução do seu fluxo de trabalho. Você também pode fazer o download dos artefatos de um fluxo de trabalho. Para saber mais, confira [Armazenar e compartilhar dados com artefatos de fluxo de trabalho](/pt/enterprise-server@3.18/actions/tutorials/store-and-share-data). É necessário o acesso de leitura ao repositório é para executar essas etapas.\n\n1. Em GitHub, acesse a página principal do repositório.\n2. No nome do repositório, clique em ** Actions**.\n\n \n3. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver.\n\n \n4. Na lista de execuções de fluxo de trabalho, clique no nome da execução para ver o resumo da execução do fluxo de trabalho.\n5. Em **Trabalhos** ou no grafo de visualização, clique no trabalho que deseja ver.\n6. No canto superior direito do log, selecione o menu suspenso e, em seguida, clique em **Baixar arquivo de log**.\n\n \n\n> \\[!NOTE]\n> Quando você baixa o arquivo morto de log de um fluxo de trabalho que foi parcialmente executado novamente, o arquivo morto só inclui os trabalhos que foram executados de novo. Para obter um conjunto completo de logs de trabalhos que foram executados a partir de um fluxo de trabalho, você deve fazer o download dos arquivos de logs para as tentativas anteriores que executaram os outros trabalhos.\n\n## Excluir registros\n\nVocê pode excluir os arquivos de log das execuções do seu fluxo de trabalho por meio da interface web GitHub ou programaticamente. É necessário o acesso de gravação ao repositório é para executar essas etapas.\n\n### Excluindo logs por meio da interface da Web GitHub\n\n1. Em GitHub, acesse a página principal do repositório.\n\n2. No nome do repositório, clique em ** Actions**.\n\n \n\n3. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver.\n\n \n\n4. Na lista de execuções de fluxo de trabalho, clique no nome da execução para ver o resumo da execução do fluxo de trabalho.\n\n5. No canto superior direito, selecione o menu suspenso e, em seguida, clique em **Excluir todos os logs**.\n\n \n\n6. Leia o aviso de confirmação.\n\nApós a exclusão dos logs, o botão **Excluir todos os logs** é removido para indicar que nenhum arquivo de log permanece na execução de fluxo de trabalho.\n\n### Excluir logs programaticamente\n\nVocê pode usar o script a seguir para excluir automaticamente todos os logs de um fluxo de trabalho. Essa pode ser uma maneira útil de limpar logs para várias execuções de fluxo de trabalho.\n\nPara executar o script de exemplo abaixo:\n\n1. Copie o exemplo de código e salve-o em um arquivo chamado `delete-logs.sh`.\n2. Conceda a ele a permissão de execução com `chmod +x delete-logs.sh`.\n3. Execute o comando a seguir, em que `REPOSITORY_NAME` é o nome do repositório e `WORKFLOW_NAME` é o nome do arquivo do fluxo de trabalho.\n\n ```shell copy\n ./delete-logs.sh REPOSITORY_NAME WORKFLOW_NAME\n ```\n\n Por exemplo, para excluir todos os logs no repositório `monalisa/octocat` do fluxo de trabalho `.github/workflows/ci.yaml`, você executaria `./delete-logs.sh monalisa/octocat ci.yaml`.\n\n#### Script de exemplo\n\n```bash copy\n#!/usr/bin/env bash\n\n# Delete all logs for a given workflow\n# Usage: delete-logs.sh \n\nset -oe pipefail\n\nREPOSITORY=$1\nWORKFLOW_NAME=$2\n\n# Validate arguments\nif [[ -z \"$REPOSITORY\" ]]; then\n echo \"Repository is required\"\n exit 1\nfi\n\nif [[ -z \"$WORKFLOW_NAME\" ]]; then\n echo \"Workflow name is required\"\n exit 1\nfi\n\necho \"Getting all completed runs for workflow $WORKFLOW_NAME in $REPOSITORY\"\n\nRUNS=$(\n gh api \\\n -H \"Accept: application/vnd.github+json\" \\\n -H \"X-GitHub-Api-Version: 2022-11-28\" \\\n \"/repos/$REPOSITORY/actions/workflows/$WORKFLOW_NAME/runs\" \\\n --paginate \\\n --jq '.workflow_runs[] | select(.conclusion != \"\") | .id'\n)\n\necho \"Found $(echo \"$RUNS\" | wc -l) completed runs for workflow $WORKFLOW_NAME\"\n\n# Delete logs for each run\nfor RUN in $RUNS; do\n echo \"Deleting logs for run $RUN\"\n gh api \\\n --silent \\\n --method DELETE \\\n -H \"Accept: application/vnd.github+json\" \\\n -H \"X-GitHub-Api-Version: 2022-11-28\" \\\n \"/repos/$REPOSITORY/actions/runs/$RUN/logs\" || echo \"Failed to delete logs for run $RUN\"\n\n # Sleep for 100ms to avoid rate limiting\n sleep 0.1\ndone\n```\n\n## Exibindo logs com GitHub CLI\n\n> \\[!NOTE]\n> Para saber mais sobre GitHub CLI, confira [Sobre GitHub CLI](/pt/enterprise-server@3.18/github-cli/github-cli/about-github-cli).\n\nPara ver o log de um trabalho específico, use o subcomando `run view`. Substitua `run-id` pela ID da execução para a qual deseja ver os logs.\nGitHub CLI retorna um menu interativo para você escolher um trabalho na execução. Se você não especificar `run-id`, GitHub CLI exibirá um menu interativo para que você escolha uma execução recente e, em seguida, exibirá outro menu interativo para que você escolha uma tarefa dessa execução.\n\n```shell\ngh run view RUN_ID --log\n```\n\nUse também o sinalizador `--job` para especificar uma ID de trabalho. Substitua `job-id` pela ID do trabalho para o qual você deseja ver os logs.\n\n```shell\ngh run view --job JOB_ID --log\n```\n\nVocê pode usar `grep` para buscar no log. Por exemplo, este comando retornará todas as entradas do log que contêm a palavra `error`.\n\n```shell\ngh run view --job JOB_ID --log | grep error\n```\n\nPara filtrar os logs de qualquer etapa com falha, use `--log-failed` em vez de `--log`.\n\n```shell\ngh run view --job JOB_ID --log-failed\n```"}