Skip to main content
Wir veröffentlichen regelmäßig Aktualisierungen unserer Dokumentation, und die Übersetzung dieser Seite ist möglicherweise noch nicht abgeschlossen. Aktuelle Informationen findest du in der englischsprachigen Dokumentation.
All products
GitHub Actions

Aktivieren der Debugprotokollierung

In diesem Artikel

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.

Hinweis: GitHub-gehostete Runner werden auf GitHub Enterprise Server derzeit nicht unterstützt. Weitere Informationen zur geplanten zukünftigen Unterstützung findest Du in der GitHub public roadmap.

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 für ein persönliches Kontorepository zu erstellen, musst du Repositorybesitzer*in sein. Um Geheimnisse für ein Organisationsrepository zu erstellen, musst du über admin-Zugriff verfügen.
  • Um Geheimnisse für eine Umgebung in einem persönlichen Kontorepository zu erstellen, musst du Repositorybesitzer*in sein. Um Geheimnisse 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.
  • Um Geheimnisse auf Organisationsebene zu erstellen, musst du über admin-Zugriff verfügen.

Weitere Informationen zum Festlegen von Geheimnissen findest du unter Verschlüsselte Geheimnisse.

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 in dem Repository fest, das den Workflow enthält: ACTIONS_RUNNER_DEBUG auf true.
  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 in dem Repository fest, das den Workflow enthält: ACTIONS_STEP_DEBUG auf true.
  2. Nach dem Festlegen des Geheimnisses werden weitere Debugereignisse in den Schrittprotokollen angezeigt. Weitere Informationen findest du unter Verwenden von Workflowausführungsprotokollen.