Logging

Logging aktivieren

Transfer Appliance verwendet Logging, um bestimmte auf der Appliance generierte Systemlogs zu Google Cloud-Beobachtbarkeit zu exportieren, sodass der Zugriff darauf erleichtert wird.

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. Nach dem Hinzufügen oder Ändern von Rollen muss der Dienstkontoschlüssel nicht neu generiert werden.

  • Wenn Sie die Onlineübertragung 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.

Gehen Sie so vor:

  1. Stellen Sie eine Verbindung zur Appliance her.
  2. Melden von Protokollen aus der Appliance starten

ta logging start

Protokollierung auf der Appliance deaktivieren

Führen Sie den folgenden Befehl über die Transfer Appliance-Befehlszeile aus, um die Berichterstellung für die Appliance zu beenden:

ta logging stop

Logs ansehen

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

labels.sessionID={sessionID}

Im Folgenden sind einige der Logs aufgeführt, die exportiert werden:

  • Fließende 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 in Ihre Appliance finden Sie unter Nutzerverwaltetes Dienstkonto erstellen und konfigurieren.