Diese Version von GitHub Enterprise wurde eingestellt am 2021-09-23. Es wird keine Patch-Freigabe vorgenommen, auch nicht für kritische Sicherheitsprobleme. Für eine bessere Leistung, verbesserte Sicherheit und neue Features nimm ein Upgrade auf die neueste Version von GitHub Enterprise vor. Wende Dich an den GitHub Enterprise-Support, um Hilfe beim Upgrade zu erhalten.

Using workflow run logs

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

Note: GitHub Actions was available for GitHub Enterprise Server 2.22 as a limited beta. The beta has ended. GitHub Actions is now generally available in GitHub Enterprise Server 3.0 or later. For more information, see the GitHub Enterprise Server 3.0 release notes.


Note: GitHub-hosted runners are not currently supported on GitHub Enterprise Server. You can see more information about planned future support on the GitHub public roadmap.

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 Enterprise Server 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. Klicke in der linken Seitenleiste auf den Auftrag, den Du sehen willst. Select a workflow job

  6. Expand the Run Super-Linter step to view 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 Enterprise Server 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. Klicke in der linken Seitenleiste auf den Auftrag, den Du sehen willst. Select a workflow job

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

  7. 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 Enterprise Server 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. Klicke in der linken Seitenleiste auf den Auftrag, den Du sehen willst. Select a workflow 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 Enterprise Server 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 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 learn more about GitHub CLI, see "About 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