Logging

Logging aktivieren

Transfer Appliance nutzt Logging, um bestimmte auf der Appliance generierte Systemlogs in Google Cloud Observability zu exportieren, 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 zugewiesen 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 das Logging ist nur die Rolle Logging Log Writer erforderlich.

Nachdem Sie die erforderlichen Schritte ausgeführt haben:

1. Stellen Sie eine Verbindung zur Appliance her.
2. Protokolle für die Appliance melden

ta logging start

Protokollierung auf der Appliance deaktivieren

Um die Berichterstellung von der Appliance zu beenden, führen Sie in der Transfer Appliance-Befehlszeile den folgenden Befehl aus:

ta logging stop

Logs ansehen

Zum Abfragen von Logs können Sie das Feld label.sessionID in der Google Cloud-Beobachtbarkeit von Google Cloud verwenden.

labels.sessionID={sessionID}

Im Folgenden sind einige der exportierten Logs aufgeführt:

• Fließender Bit

• Docker

• Kernel

• Metadatenpartition

  • Erfassung

  • ta_check

  • activation_service

Sie können die Logs 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 Dienstkonto-Schlüsseldatei /tmp/key.json auf der Appliance nicht gefunden wird, wird ein Fehler zurückgegeben.

Eine Anleitung zum Konfigurieren eines Dienstkontos und zum Kopieren der Schlüsseldatei auf Ihre Appliance finden Sie unter Nutzerverwaltetes Dienstkonto erstellen und konfigurieren.