Logging

Logging aktivieren

Transfer Appliance nutzt Logging, um bestimmte Systemprotokolle zu exportieren, die auf der Appliance mit Google Cloud Observability verknüpfen, 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 Ihrem Konto dem Dienstkonto die Rolle Logging Log Writer zu, nicht mehr 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. Keine Notwendigkeit Generieren Sie den Dienstkontoschlüssel neu, nachdem Sie Rollen hinzugefügt oder geändert haben.

• Wenn Sie die Onlineübertragung noch nicht eingerichtet haben, folgen Sie der Anleitung zum Erstellen und konfigurieren Sie ein nutzerverwaltetes Dienstkonto. Nur die Die Rolle Logging Log Writer ist für das Logging erforderlich.

Nachdem Sie die erforderlichen Schritte ausgeführt haben:

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

ta logging start

Protokollierung auf der Appliance deaktivieren

Um die Berichterstellung von der Appliance zu stoppen, führen Sie über die Transfer Appliance-Befehlszeile:

ta logging stop

Logs ansehen

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

labels.sessionID={sessionID}

Im Folgenden sind einige der exportierten Logs aufgeführt:

• Fluent Bit

• Docker

• Kernel

• Metadatenpartition

  • Erfassung

  • 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.