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 oder Variablen festgelegt werden. Somit gelten die gleichen Berechtigungsvoraussetzungen:

  • Um Geheimnisse oder Variablen auf GitHub für ein Repository eines persönlichen Kontos zu erstellen, musst du Repositorybesitzer*in sein. Um Geheimnisse oder Variablen auf GitHub für ein Organisationsrepository zu erstellen, musst du über admin-Zugriff verfügen. Um Geheimnisse oder Variablen für ein Repository eines persönlichen Kontos oder einer Organisation über die REST-API zu erstellen, musst du über Projektmitarbeiterzugriff 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. Weitere Informationen zu Umgebungen findest du unter Verwenden von Umgebungen für die Bereitstellung.
  • Organisationsbesitzer*innen können Geheimnisse oder Variablen auf Organisationsebene erstellen.

Weitere Informationen zum Festlegen von Geheimnissen und Variablen findest du unter Verwenden von Geheimnissen in GitHub-Aktionen und unter Variablen.

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. Um die Runner-Diagnoseprotokollierung zu aktivieren, lege das folgende Geheimnis oder die folgende Variable in dem Repository fest, das den Workflow enthält: ACTIONS_RUNNER_DEBUG auf true. Wenn sowohl das Geheimnis als auch die Variable festgelegt sind, hat der Wert des Geheimnisses Vorrang vor der Variablen.
  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 Verwenden von Workflowausführungsprotokollen.

Debug-Schrittprotokollierung aktivieren

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

  1. Um die Debug-Schrittprotokollierung zu aktivieren, lege das folgende Geheimnis oder die folgende Variable in dem Repository fest, das den Workflow enthält: ACTIONS_STEP_DEBUG auf true. Wenn sowohl das Geheimnis als auch die Variable festgelegt sind, hat der Wert des Geheimnisses Vorrang vor der Variablen.
  2. Nach dem Festlegen des Geheimnisses oder der Variablen werden weitere Debugereignisse in den Schrittprotokollen angezeigt. Weitere Informationen findest du unter Verwenden von Workflowausführungsprotokollen.