Logging

Logging aktivieren

Bei der Transfer Appliance werden bestimmte auf der Appliance generierte Systemprotokolle mithilfe von Protokollierung in Google Cloud Observability exportiert, um den Zugriff darauf zu erleichtern.

Die Schritte zum Aktivieren des Loggings hängen davon ab, ob Sie die Onlineübertragung eingerichtet haben:

  • Wenn Sie die Onlineübertragung eingerichtet und dem Dienstkonto die Rolle Logging Log Writer gewährt haben, ist keine weitere Konfiguration erforderlich.

  • Wenn Sie die Onlineübertragung eingerichtet, aber die Rolle Logging Log Writer nicht hinzugefügt haben, fügen Sie die Rolle Ihrem nutzerverwalteten Dienstkonto auf Projektebene hinzu. Der Dienstkontoschlüssel muss nach dem Hinzufügen oder Ändern von Rollen nicht neu generiert werden.

  • Wenn Sie die Onlineübertragung noch nicht eingerichtet haben, folgen Sie der Anleitung zum Erstellen und Konfigurieren eines nutzerverwalteten Dienstkontos. Für die Protokollierung ist nur die Rolle Logging Log Writer erforderlich.

Nachdem Sie die erforderlichen Schritte ausgeführt haben, geschieht Folgendes:

  1. Stellen Sie eine Verbindung zur Appliance her.
  2. Protokolle von der Appliance erfassen

ta logging start

Logging auf dem Gerät deaktivieren

Wenn Sie das Erfassen von Protokollen von der Appliance beenden möchten, führen Sie den folgenden Befehl in der Befehlszeile der Transfer Appliance aus:

ta logging stop

Logs ansehen

Sie können Logs mithilfe des Felds label.sessionID in Google Cloud Observability abfragen.

labels.sessionID={sessionID}

Im Folgenden sind einige der exportierten Protokolle aufgeführt:

  • Fluent Bit

  • Docker

  • Kernel

  • Metadatenpartition

    • Aufnahme

    • ta_check

    • activation_service

Sie können die Protokolle in Cloud Logging mithilfe der Google Cloud Console, der Google Cloud CLI oder der Logging API aufrufen.

Fehlerbehebung

An error occurred while enabling logging

Wenn die Dienstkontoschlüsseldatei /tmp/key.json auf dem Gerät nicht gefunden wird, wird ein Fehler zurückgegeben.

Eine Anleitung zum Konfigurieren eines Dienstkontos und zum Kopieren der Schlüsseldatei auf die Appliance finden Sie unter Vom Nutzer verwaltetes Dienstkonto erstellen und konfigurieren.