Verwalten von Protokolldateien

Mit der Azure Sphere CLI können Sie entscheiden, ob Sie Diagnose- und Konfigurationsinformationen von Ihrem Computer, der Cloud und dem angefügten Azure Sphere-Gerät in eine Protokolldatei einschließen möchten. Sie können die Protokollierung entweder über die CLI für eine bestimmte Sitzung aktivieren oder deaktivieren oder die Umgebungsvariable dauerhaft festlegen.

Hinweis

  • Dieses Feature wird in der klassischen Azure Sphere-Befehlszeilenschnittstelle nicht unterstützt.
  • Wenn die Umgebungsvariable nicht festgelegt ist, ist die Protokollierung standardmäßig deaktiviert.

Konfigurieren der Protokollierung in der CLI

Die Protokollierung wird durch Festlegen der Umgebungsvariable AZSPHERE_FILE_LOGGING_DISABLEDkonfiguriert. Wenn die Protokollierung aktiviert ist, wird eine Protokolldatei im Verzeichnis C:\Users<user.azsphere>\logs unter Windows und ~/.azsphere/logs unter Linux erstellt. Darüber hinaus sind die Informationen auch in der .zip Datei enthalten, die beim Ausführen des az sphere get-support-data Befehls erstellt wird.

Beispiel

Hier sehen Sie ein Beispiel für die Konfiguration der Protokollierung mithilfe der CLI:

Hinweis

Die von Ihnen festgelegten Einstellungen gelten nur für die aktuelle CLI-Sitzung, in der Sie sich befinden, und sind nicht sitzungsübergreifend persistent. Informationen zum dauerhaften Festlegen Ihrer Einstellung finden Sie in der Dokumentation, die für Ihr Betriebssystem bereitgestellt wird.

Folgende Werte werden unterstützt:

  • 0 zum Aktivieren der Protokollierung
  • 1 zum Deaktivieren der Protokollierung
  • Wenn nicht festgelegt, ist die Protokollierung deaktiviert.

Windows-Eingabeaufforderung

So aktivieren Sie die Protokollierung:

set AZSPHERE_FILE_LOGGING_DISABLED=0

So deaktivieren Sie die Protokollierung:

set AZSPHERE_FILE_LOGGING_DISABLED=1

So löschen Sie die Einstellung:

set AZSPHERE_FILE_LOGGING_DISABLED=

Geben Sie in der Eingabeaufforderung ein, set AZSPHERE_FILE_LOGGING_DISABLED um den Wert der Umgebungsvariablen anzuzeigen.

Windows PowerShell

Sie können den Befehl über die Windows-Eingabeaufforderung ausführen und Windows PowerShell:

So aktivieren Sie die Protokollierung:

$env:AZSPHERE_FILE_LOGGING_DISABLED=0

So deaktivieren Sie die Protokollierung:

$env:AZSPHERE_FILE_LOGGING_DISABLED=1

So löschen Sie die Einstellung:

Remove-Item -Path Env:AZSPHERE_FILE_LOGGING_DISABLED

Um den Wert der Umgebungsvariablen anzuzeigen, geben Sie PowerShell ein dir env: , und suchen Sie AZSPHERE_FILE_LOGGING_DISABLED in der Liste.