Protokolle sind nicht detailliert genug

Wenn Ihre Protokolle nicht detailliert genug sind, um ein Problem zu beheben, gibt es mehrere Schritte, die Sie ausführen können, um zusätzliche Informationen zu erhalten und Protokolle nützlicher zu machen.

Debug-Schrittprotokollierung aktivieren

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

So aktivieren Sie die Schritt-Debugprotokollierung:

1. Legen Sie im Repository, das den Workflow enthält, den folgenden geheimen Schlüssel oder die variable fest: 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. Führen Sie den Workflow erneut aus, oder lösen Sie eine neue Ausführung aus.

Sobald Sie das Geheimnis oder die Variable festgelegt haben, werden weitere Debug-Ereignisse in den Schrittprotokollen aufgeführt. Weitere Informationen findest du unter Verwenden von Workflowausführungsprotokollen.

Sie können den runner.debug Kontext auch verwenden, um Schritte nur bedingt auszuführen, wenn die Debugprotokollierung aktiviert ist. Weitere Informationen findest du unter Kontextreferenz.

Erstellen von CodeQL Debuggingartefakten

Sie können Artefakte abrufen, die Ihnen beim DebuggenCodeQL helfen. Die Debugartefakte werden in die Workflowausführung hochgeladen, als Artefakte mit Namen, die mit debug-artifacts beginnen. Wenn CodeQL während der Workflowausführung mehrere Sprachen gleichzeitig analysiert, wird für jede Sprache ein solches Artefakt erstellt. Die Daten enthalten die CodeQL Protokolle, CodeQL Datenbanken, extrahierten Quellcodedateien und alle SARIF-Dateien, die vom Workflow erstellt werden. Weitere Informationen zum Herunterladen von CodeQL Artefakten finden Sie unter Herunterladen von Workflowartefakten.

Diese Artefakte helfen Ihnen beim Debuggen von Problemen mit CodeQLcode scanning. Wenn Sie kontaktieren GitHub-Support, werden sie möglicherweise nach diesen Daten gefragt.

Erstellen von CodeQL Debugging-Artefakten für CodeQL die Standardkonfiguration

Sie können CodeQL Debugging-Artefakte erstellen, indem Sie die Debugprotokollierung für Schritte aktivieren (siehe Debugprotokollierung für Schritte aktivieren) und eine neue CodeQL Analyse auslösen, indem Sie beispielsweise einen neuen Commit in einen Pull-Request-Branch pushen.

Erstellen von CodeQL Debuggingartefakten für CodeQL das erweiterte Setup

Debugging-Artefakte für CodeQL die erweiterte Einrichtung können auf verschiedene Arten bezogen werden.

Erneute Ausführung von Aufträgen mit aktivierter Debugprotokollierung

Die einfachste Option zum Erstellen von Debuggingartefakten für CodeQL das erweiterte Setup ist die erneute Ausführung von Aufträgen mit aktivierter Debugprotokollierung. Weitere Informationen zum erneuten Ausführen GitHub Actions von Workflows und Aufträgen finden Sie unter Erneutes Ausführen von Workflows und Jobs.

Du musst sicherstellen, dass du Debugprotokollierung aktivieren auswählst. Dadurch werden die Runnerdiagnoseprotokollierung und die schrittweise Debugprotokollierung für die Ausführung aktiviert. Anschließend können Sie Debuggingartefakte herunterladen CodeQL , um weitere Untersuchungen durchzuführen. Sie müssen die Workflowdatei beim Erstellen CodeQL von Debuggingartefakten nicht durch erneute Ausführung von Aufträgen ändern.

Verwenden eines Workflow-Kennzeichens

Sie können Debugartefakte mithilfe einer Kennzeichnung in Ihrem Workflow erstellen CodeQL . Dazu müssen Sie den Schritt init in Ihrer CodeQL-Analyse-Workflow-Datei ändern und debug: true festlegen.

- name: Initialize CodeQL
  uses: github/codeql-action/init@v4
  with:
    debug: true

Verwendung von GitHub Actions Debugprotokollierung auf Schrittebene

Wenn Sie GitHub Actions die Debugprotokollierung für Schritte aktivieren, erstellt CodeQL auch Debugartefakte und lädt sie im Rahmen der Workflowausführung hoch. Anweisungen finden Sie unter Aktivieren der Schritt-Debugprotokollierung.