Using workflow run logs

Auf der Workflow-Lauf-Seite können sie sehen, ob ein Workflow-Lauf ausgeführt wird oder abgeschlossen ist. Sie müssen mit einem GitHub-Konto angemeldet sein, um Workflow-Informationen anzuzeigen, auch für öffentliche Repositories. Weitere Informationen finden Sie unter „Zugriffsberechtigungen auf GitHub“.

Wenn der Lauf abgeschlossen ist, können Sie sehen, ob das Ergebnis erfolgreich, fehlerhaft, abgebrochen oder neutral war. Wenn der Lauf fehlgeschlagen ist, können Sie die Build-Protokolle anzeigen und durchsuchen, um den Fehler zu diagnostizieren und den Workflow erneut auszuführen. Sie können auch fakturierbare Auftragsausführungsminuten anzeigen oder Protokolle herunterladen und Artefakte erstellen.

GitHub Actions verwenden die Checks API, um Status, Ergebnisse und Protokolle für einen Workflow auszugeben. GitHub erstellt eine neue Prüfsuite für jeden Workflow-Lauf. Die Prüfsuite enthält einen Prüflauf für jeden Auftrag im Workflow, und jeder Auftrag enthält Schritte. GitHub Actions werden als Schritt in einem Workflow ausgeführt. For more information about the Checks API, see "Checks."

Protokolle zur Fehlerdiagnose anzeigen

Wenn Ihr Workflow-Lauf fehlschlägt, können Sie sehen, welcher Schritt den Fehler verursacht hat, und die Build-Protokolle des fehlgeschlagenen Schrittes zur Fehlerbehebung überprüfen. Sie sehen, wie lange es gedauert hat, bis jeder Schritt ausgeführt wurde. Sie können außerdem einen Permalink in eine bestimmte Zeile in der Protokolldatei kopieren, um ihn mit Ihrem Team zu teilen. Read access to the repository is required to perform these steps.

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. Navigiere in GitHub Enterprise Server zur Hauptseite des Repository.

2. Klicke unter Deinem Repository-Namen auf Actions (Aktionen).

3. Klicke in der linken Seitenleiste auf den Workflow, den Du sehen willst.

4. From the list of workflow runs, click the name of the run you want to see.

5. Klicke in der linken Seitenleiste auf den Auftrag, den Du sehen willst.

6. Expand the Run Super-Linter step to view the results.

7. Klicke bei Bedarf auf die Zeilennummer des Schritts, um einen Link zu einer bestimmten Zeile in den Logs zu erhalten. You can then copy the link from the address bar of your web browser.

Protokolle durchsuchen

Sie können die Build-Protokolle für einen bestimmten Schritt durchsuchen. Beim Durchsuchen von Protokollen werden nur eingeblendete Schritte in die Ergebnisse einbezogen. Read access to the repository is required to perform these steps.

1. Navigiere in GitHub Enterprise Server zur Hauptseite des Repository.

2. Klicke unter Deinem Repository-Namen auf Actions (Aktionen).

3. Klicke in der linken Seitenleiste auf den Workflow, den Du sehen willst.

4. From the list of workflow runs, click the name of the run you want to see.

5. Klicke in der linken Seitenleiste auf den Auftrag, den Du sehen willst.

6. Um jeden Schritt, den Sie in Ihre Suche einbeziehen möchten, einzublenden, klicken Sie auf den Schritt.

7. Gib in der oberen rechten Ecke der Protokollausgabe im Suchfeld Search logs (Protokolle durchsuchen) eine Suchanfrage ein.

Herunterladen von Protokollen

Sie können die Protokolldateien von Ihrem Workflowlauf herunterladen. Sie können auch die Artefakte eines Workflows herunterladen. Weitere Informationen findest Du unter „Workflow-Daten mittels Artefakten persistieren“. Read access to the repository is required to perform these steps.

1. Navigiere in GitHub Enterprise Server zur Hauptseite des Repository.

2. Klicke unter Deinem Repository-Namen auf Actions (Aktionen).

3. Klicke in der linken Seitenleiste auf den Workflow, den Du sehen willst.

4. From the list of workflow runs, click the name of the run you want to see.

5. Klicke in der linken Seitenleiste auf den Auftrag, den Du sehen willst.

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

Logs löschen

Du kannst die Logdateien aus Deiner Workflow-Ausführung löschen. Write access to the repository is required to perform these steps.

1. Navigiere in GitHub Enterprise Server zur Hauptseite des Repository.

2. Klicke unter Deinem Repository-Namen auf Actions (Aktionen).

3. Klicke in der linken Seitenleiste auf den Workflow, den Du sehen willst.

4. From the list of workflow runs, click the name of the run you want to see.

5. In the upper right corner, click .

6. Um die Logdateien zu löschen, klicke auf Delete all logs (Alle Logs löschen) und überprüfe die Bestätigungsanfrage. After the logs have been deleted, the Delete all logs button is removed to indicate that no log files remain in the workflow run.

Viewing logs with 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