Skip to main content

Aktivieren der Debugprotokollierung

Wenn die Workflow-Logs nicht genügend Details zur Diagnose enthalten, warum ein Workflow, ein Job oder ein Schritt nicht wie erwartet abläuft, kannst du die zusätzliche Debug-Protokollierung aktivieren.

Diese zusätzlichen Protokolle werden aktiviert, wenn in dem Repository, das den Workflow enthält, Geheimnisse festgelegt werden. Somit gelten die gleichen Berechtigungsvoraussetzungen:

  • Um Geheimnisse oder Variablen für ein persönliches Kontorepository zu erstellen, musst du Repositorybesitzer*in sein. Um Geheimnisse oder Variablen für ein Organisationsrepository zu erstellen, musst du über admin-Zugriff verfügen.
  • Um Geheimnisse oder Variablen für eine Umgebung in einem persönlichen Kontorepository zu erstellen, musst du Repositorybesitzer*in sein. Um Geheimnisse oder Variablen für eine Umgebung in einem Organisationsrepository zu erstellen, musst du über admin-Zugriff verfügen.
  • Um Geheimnisse oder Variablen auf Organisationsebene zu erstellen, musst du über admin-Zugriff verfügen.
  • Um Geheimnisse mithilfe der REST-API zu erstellen, musst du über Schreibzugriff auf das Repository oder über Administratorzugriff auf die Organisation verfügen. Weitere Informationen findest du unter GitHub Actions-Geheimnis-API.

Weitere Informationen findest du unter Erstellen und Verwenden verschlüsselter Geheimnisse.

Darüber hinaus kann jeder, der Zugriff auf die Ausführung eines Workflows hat, die Runnerdiagnoseprotokollierung und die schrittweise Debugprotokollierung für einen Workflow erneut ausführen. Weitere Informationen findest Du unter Erneutes Ausführen von Workflows und Jobs.

Diagnose-Protokollierung des Runners aktivieren

Die Runner-Diagnoseprotokollierung bietet zusätzliche Protokolldateien mit Informationen zur Ausführung eines Auftrags durch einen Runner. In das Protokollarchiv werden zwei weitere Protokolldateien aufgenommen:

  • das Runner-Prozessprotokoll mit Informationen zur Koordinierung und Einrichtung von Runnern für die Ausführung von Aufträgen
  • das Worker-Prozessprotokoll, in dem die Ausführung eines Auftrags protokolliert wird
  1. Für die Aktivierung der Runner-Diagnoseprotokollierung muss in dem Repository, das den Workflow enthält, das Geheimnis ACTIONS_RUNNER_DEBUG auf true festgelegt werden.

  2. Sollen die Runner-Diagnoseprotokolle heruntergeladen werden, lade das Protokollarchiv des Workflow-Laufs herunter. Die Runner-Diagnoseprotokolle befinden sich im Ordner runner-diagnostic-logs. Weitere Informationen zum Herunterladen von Protokollen findest du unter Herunterladen von Protokollen.

Debug-Schrittprotokollierung aktivieren

Bei der Debug-Schrittprotokollierung werden ausführlichere Protokolle während und nach der Ausführung eines Auftrags erstellt.

  1. Zum Aktivieren der Debug-Schrittprotokollierung muss in dem Repository, das den Workflow enthält, das Geheimnis ACTIONS_STEP_DEBUG auf true festgelegt werden.

  2. Sobald du das Geheimnis festgelegt hast, werden weitere Debug-Ereignisse in den Schrittprotokollen aufgeführt. Weitere Informationen findest du unter Protokolle zur Fehlerdiagnose anzeigen.