Using workflow run logs

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

GitHub Actions ist verfügbar mit GitHub Free, GitHub Pro, GitHub Free für Organisationen, GitHub Team, GitHub Enterprise Cloud, und GitHub AE. GitHub Actions ist nicht verfügbar für private Repositorys, die im Besitz von Konten mit älteren Pro-Repository-Plänen sind. For more information, see "GitHub's products."

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."

Hinweis: Stelle sicher, dass Du nur gültige Workflowdateien an Dein Repository freigibst. Wenn .github/workflows eine ungültige Workflowdatei enthält, erzeugt GitHub Actions für jeden neuen Commit einer fehlgeschlagenen Workflow-Ausführung.

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 zur Hauptseite des Repository.

  2. Klicke unter Deinem Repository-Namen auf Actions (Aktionen). Registerkarte „Actions" (Aktionen) auf der Navigationsleiste des Haupt-Repository

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

  4. From the list of workflow runs, click the name of the run you want to see. Name der Workflow-Ausführung

  5. Under Jobs or in the visualization graph, click the job you want to see. Lint code base job

  6. Any failed steps are automatically expanded to display the results.

    Super linter workflow 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.

    Schaltfläche zum Kopieren des Links

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 zur Hauptseite des Repository.

  2. Klicke unter Deinem Repository-Namen auf Actions (Aktionen). Registerkarte „Actions" (Aktionen) auf der Navigationsleiste des Haupt-Repository

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

  4. From the list of workflow runs, click the name of the run you want to see. Name der Workflow-Ausführung

  5. Under Jobs or in the visualization graph, click the job you want to see. Lint code base job

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

    Suchfeld zum Durchsuchen von Protokollen

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 zur Hauptseite des Repository.

  2. Klicke unter Deinem Repository-Namen auf Actions (Aktionen). Registerkarte „Actions" (Aktionen) auf der Navigationsleiste des Haupt-Repository

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

  4. From the list of workflow runs, click the name of the run you want to see. Name der Workflow-Ausführung

  5. Under Jobs or in the visualization graph, click the job you want to see. Lint code base job

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

    Dropdownmenü zum Herunterladen von Protokollen

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 zur Hauptseite des Repository.

  2. Klicke unter Deinem Repository-Namen auf Actions (Aktionen). Registerkarte „Actions" (Aktionen) auf der Navigationsleiste des Haupt-Repository

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

  4. From the list of workflow runs, click the name of the run you want to see. Name der Workflow-Ausführung

  5. In the upper right corner, click .

    Kebab-horizontal icon

  6. Um die Logdateien zu löschen, klicke auf Delete all logs (Alle Logs löschen) und überprüfe die Bestätigungsanfrage.

    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

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

Did this doc help you?Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Oder, learn how to contribute.