Using workflow run logs

You can view, search, and download the logs for each job in a workflow run.

You can see whether a workflow run is in progress or complete from the workflow run page. You must be logged in to a GitHub account to view workflow run information, including for public repositories. For more information, see "Access permissions on GitHub."

If the run is complete, you can see whether the result was a success, failure, canceled, or neutral. If the run failed, you can view and search the build logs to diagnose the failure and re-run the workflow. You can also view billable job execution minutes, or download logs and build artifacts.

GitHub Actions use the Checks API to output statuses, results, and logs for a workflow. GitHub creates a new check suite for each workflow run. The check suite contains a check run for each job in the workflow, and each job includes steps. GitHub Actions are run as a step in a workflow. For more information about the Checks API, see "Checks."

Nota: Garanta que você só faça commit de arquivos de fluxo de trabalho válidos no seu repositório. Se .github/workflows contiver um arquivo de fluxo de trabalho inválido, GitHub Actions gera uma falha na execução do fluxo de trabalho para cada novo commit.

Viewing logs to diagnose failures

If your workflow run fails, you can see which step caused the failure and review the failed step's build logs to troubleshoot. You can see the time it took for each step to run. You can also copy a permalink to a specific line in the log file to share with your team. É necessário o acesso de leitura ao repositório é para executar essas etapas.

In addition to the steps configured in the workflow file, GitHub adds two additional steps to each job to set up and complete the job's execution. These steps are logged in the workflow run with the names "Set up job" and "Complete job".

For jobs run on GitHub-hosted runners, "Set up job" records details of the runner's virtual environment, and includes a link to the list of preinstalled tools that were present on the runner machine.

  1. No your enterprise, navegue até a página principal do repositório.

  2. No nome do seu repositório, clique em Ações. Aba Ações na navegação principal do repositório

  3. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver. Lista de fluxo de trabalho na barra lateral esquerda

  4. Na lista de execuções do fluxo de trabalho, clique no nome da execução que você deseja visualizar. Nome da execução do fluxo de trabalho

  5. Na barra lateral esquerda, clique no trabalho que você deseja ver. Selecione um trabalho do fluxo de trabalho

  6. Expanda a etapa Executar Super-Linter para visualizar os resultados. Resultados do fluxo de trabalho do Super linter

  7. 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. Botão para copiar link

Searching logs

You can search the build logs for a particular step. When you search logs, only expanded steps are included in the results. É necessário o acesso de leitura ao repositório é para executar essas etapas.

  1. No your enterprise, navegue até a página principal do repositório.

  2. No nome do seu repositório, clique em Ações. Aba Ações na navegação principal do repositório

  3. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver. Lista de fluxo de trabalho na barra lateral esquerda

  4. Na lista de execuções do fluxo de trabalho, clique no nome da execução que você deseja visualizar. Nome da execução do fluxo de trabalho

  5. Na barra lateral esquerda, clique no trabalho que você deseja ver. Selecione um trabalho do fluxo de trabalho

  6. In the upper-right corner of the log output, in the Search logs search box, type a search query.

    Search box to search logs

Downloading logs

You can download the log files from your workflow run. You can also download a workflow's artifacts. For more information, see "Persisting workflow data using artifacts." É necessário o acesso de leitura ao repositório é para executar essas etapas.

  1. No your enterprise, navegue até a página principal do repositório.

  2. No nome do seu repositório, clique em Ações. Aba Ações na navegação principal do repositório

  3. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver. Lista de fluxo de trabalho na barra lateral esquerda

  4. Na lista de execuções do fluxo de trabalho, clique no nome da execução que você deseja visualizar. Nome da execução do fluxo de trabalho

  5. Na barra lateral esquerda, clique no trabalho que você deseja ver. Selecione um trabalho do fluxo de trabalho

  6. In the upper right corner, click and select Download log archive.

    Download logs drop-down menu

Deleting logs

You can delete the log files from your workflow run. É necessário o acesso de gravação ao repositório é para executar essas etapas.

  1. No your enterprise, navegue até a página principal do repositório.

  2. No nome do seu repositório, clique em Ações. Aba Ações na navegação principal do repositório

  3. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver. Lista de fluxo de trabalho na barra lateral esquerda

  4. Na lista de execuções do fluxo de trabalho, clique no nome da execução que você deseja visualizar. Nome da execução do fluxo de trabalho

  5. In the upper right corner, click .

    Kebab-horizontal icon

  6. To delete the log files, click the Delete all logs button and review the confirmation prompt.

    Delete all logs

After deleting logs, the Delete all logs button is removed to indicate that no log files remain in the workflow run.

Viewing logs with GitHub CLI

Para saber mais sobre GitHub CLI, consulte "Sobre GitHub CLI."

To view the log for a specific job, use the run view subcommand. Replace run-id with the ID of run that you want to view logs for. GitHub CLI returns an interactive menu for you to choose a job from the run. If you don't specify run-id, GitHub CLI returns an interactive menu for you to choose a recent run, and then returns another interactive menu for you to choose a job from the run.

gh run view run-id --log

You can also use the --job flag to specify a job ID. Replace job-id with the ID of the job that you want to view logs for.

gh run view --job job-id --log

You can use grep to search the log. For example, this command will return all log entries that contain the word error.

gh run view --job job-id --log | grep error

To filter the logs for any failed steps, use --log-failed instead of --log.

gh run view --job job-id --log-failed

Esse documento ajudou você?

Política de Privacidade

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.