Debugging-Informationen mit sosreport erfassen

Container-Optimized OS enthält das Dienstprogramm sosreport, das bei Bedarf Informationen erfasst, um Probleme in einer VM-Instanz mit Container-Optimized OS zu beheben. Die erfassten Informationen werden lokal im Dateisystem der Instanz gespeichert. Google erfasst oder speichert diese Daten nicht an anderer Stelle.

Wenn Sie aufgrund von Problemen mit Ihrer Instanz eine Supportanfrage an den Google Cloud-Support stellen, werden Sie möglicherweise gebeten, die sosreport-Daten für die Untersuchung anzugeben. Auf dieser Seite erfahren Sie, wie Sie diese Informationen erfassen.

Hinweis: Beim Erstellen des Berichts werden CPU- und Arbeitsspeicherressourcen verbraucht. Durch das Speichern des Berichts werden Speicherplatz und E/A-Bandbreitenressourcen auf dem Knoten verbraucht. Die Menge der verbrauchten Ressourcen kann nicht einfach geschätzt werden.

Hinweis: Bei der Behebung von Knotenverfügbarkeits- und Startproblemen kann das Erfassen von sosreport schwierig sein. Die automatische Knotenreparatur hält den Knoten an und erstellt ihn nach einer Zeit der Nichtverfügbarkeit neu. Siehe Automatische Knotenreparatur deaktivieren, wenn die sosreport-Sammlung nicht erfolgen kann, bevor der Knoten durch die automatische Reparatur beendet wird. Wenn die automatische Reparatur nicht deaktiviert werden kann, da sich der Cluster in der Release-Version befindet, wenden Sie sich an den Cloud Customer Care.

Die Ausgabe von sosreport wird ohne Verschlüsselung in einem .tar.xz-Archiv gespeichert. Das Archiv kann personenbezogene Daten enthalten, da es Daten aus vielen wichtigen Systemkomponenten (z. B. journald) erfasst. Das Archiv kann auf der Instanz überprüft werden. Die meisten Inhalte liegen im Nur-Text-Format vor. Das sosreport-Tool ist Open Source und Sie können den Code prüfen.

sosreport-Daten erfassen

Stellen Sie zum Erstellen eines Berichts eine SSH-Verbindung zur entsprechenden VM-Instanz her und führen Sie folgenden gcloud compute ssh-Befehl aus:

gcloud compute ssh [INSTANCE_NAME]

Führen Sie dann den folgenden sosreport-Befehl aus:

sudo sos report --all-logs --batch --tmp-dir=/var

Hinweis: Unter Container-Optimized OS 85 und niedriger kann sosreport mit dem Befehl sudo sosreport --all-logs --batch --tmp-dir=/var

erfasst werden.

Sie können das Verzeichnis ändern, in dem der Bericht gespeichert ist. Übergeben Sie dazu ein anderes Verzeichnis an die Option --tmp-dir. Sie können das Standardverhalten des Befehls auch ändern, wenn Sie /etc/sos.conf für die Instanz bearbeiten.

Die Ausgabe wird in einer .tar.xz-Datei in dem Verzeichnis gespeichert, das Sie mit der Option --tmp-dir angeben. Speicherort und Prüfsumme der .tar.xz-Datei werden auf STDOUT angezeigt.

Your sosreport has been generated and saved in:
  /var/sosreport-cos-20181106231224.tar.xz

The checksum is: 5a8b97c6020346a688254c8b04ef86ec

Erfasste Daten anzeigen lassen

Der Bericht gehört root und ist für andere Nutzer nicht lesbar. Mit den folgenden Befehlen können Sie den Inhaber als aktuellen Nutzer festlegen. So wird der Bericht für Sie lesbar. Er sollte nicht allgemein lesbar sein.

TARBALL=[PATH/TO/TARBALL]
sudo chown $(whoami) $TARBALL
chmod +r $TARBALL

Wenn Sie sich dann den Inhalt des Berichts über den Knoten ansehen möchten, können Sie ihn mit dem folgenden Befehl extrahieren:

tar xvf $TARBALL

Die einzelnen Berichtsdateien sind jetzt in einem Verzeichnis am selben Speicherort wie .tar.xz verfügbar. Sie können die Logs mit Befehlen wie less aufrufen oder mit Befehlen wie grep nach darin enthaltenen Informationen suchen.

Hinweis: Wenn Sie den Bericht für Google freigeben möchten, ändern Sie bitte keine Dateien im Bericht. Wenn Sie einige Dateien ändern müssen, teilen Sie uns bei Freigabe des Berichts bitte mit, welche Änderungen vorgenommen wurden.

Bericht herunterladen

Mit dem Befehl gcloud compute scp können Sie den Bericht auf Ihren lokalen Computer herunterladen:

gcloud compute scp $(whoami)@[INSTANCE_NAME]:[PATH/TO/FILE] [LOCAL/PATH/TO/DIRECTORY]