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.

In diesem Artikel

Note

Auf GitHub gehostete Runner werden aktuell nicht auf GitHub Enterprise Server 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 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, müssen Sie Repositorybesitzer*in sein. Um Geheimnisse oder Variablen auf GitHub für ein Organisationsrepository zu erstellen, müssen Sie ü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, müssen Sie über Projektmitarbeiterzugriff verfügen.
  • Um Geheimnisse oder Variablen für eine Umgebung in einem Repository eines persönlichen Kontos zu erstellen, müssen Sie Besitzer des Repositorys sein. Für das Erstellen von Geheimnissen oder Variablen für eine Umgebung in einem Organisationsrepository benötigen Sie admin-Zugriff. Weitere Informationen zu Umgebungen finden Sie unter „Verwalten von Umgebungen für die Bereitstellung“.
  • Organisationsbesitzerinnen und Benutzerinnen mit den Berechtigungen „Organisationsaktionenvariablen verwalten“ oder „Organisationsaktioneneheimnisse verwalten“ können Geheimnisse oder Variablen auf Organisationsebene erstellen.

Weitere Informationen findest du unter Informationen zu benutzerdefinierten Organisationsrollen.

Weitere Informationen zum Einrichten von Geheimnissen und Variablen findest du unter Verwenden von Geheimnissen in GitHub-Aktionen und Speichern von Informationen in 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 finden Sie 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 Diagnoseprotokollierung der Runner zu aktivieren, setzen Sie das folgende Geheimnis oder die Variable in dem Repository, das den Workflow enthält: ACTIONS_RUNNER_DEBUG auf true. Wenn sowohl das Geheimnis als auch die Variable gesetzt sind, hat der Wert des Geheimnisses Vorrang vor der Variable.
  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 schrittweise Debug-Protokollierung zu aktivieren, setzen Sie im Repository, das den Workflow enthält, das folgende Geheimnis oder die folgende Variable von ACTIONS_STEP_DEBUG auf true. Wenn sowohl das Geheimnis als auch die Variable gesetzt sind, hat der Wert des Geheimnisses Vorrang vor der Variable.
  2. Sobald Sie das Geheimnis oder die Variable festgelegt haben, werden weitere Debug-Ereignisse in den Schrittprotokollen aufgeführt. Weitere Informationen finden Sie unter Verwenden von Workflowausführungsprotokollen.