NetWorker VMware Protection – vProxy: Aktivieren der Debugging-Protokollierung

Sehen Sie sich dieses Video an: So aktivieren Sie die vProxy-Debug-Protokollierung.

Methoden zum Anwenden des vProxy-Engine-Debug:

In der Regel reicht es aus, die Policy-Protokolle des NetWorker-Servers in /nsr/logs/policy/[policy name], aber gelegentlich kann es erforderlich sein, die Protokolle der vProxy-Appliance selbst zu analysieren und darüber hinaus die Protokollierungsebene für das Debuggen zu erhöhen, um eine klarere Vorstellung von der Ursache eines Fehlers zu erhalten. Dies ist in der Regel nur erforderlich, wenn der NetWorker-Support eingebunden wurde und der Supporttechniker das Debuggen und Festlegen des Troubleshootings als bestimmten Prozess angefordert hat. 

NVP-vProxy-Protokolldateien auf der vProxy-Appliance befinden sich im folgenden Verzeichnis /opt/emc/vproxy/runtime/logsaus.

Es gibt ein Unterverzeichnis für jeden der Hauptprozesse, die für NetWorker-Vorgänge auf der vProxy-Appliance verwendet werden:

vbackupd

vflrd

vrapid

vrecoverd

Beispiel: vbackupd Das Unterverzeichnis enthält die folgenden Protokolle:

[session-uuid].log             Processing details for a session
vbackupd-engine.log            Requests and problem events including error and panic messages from the session log.
vbackupd-boost.log             DD Boost logging.
vbackupd-snapmgr.log           Snapshot logging
vbackupd-vddk.log              VDDK logging -  VMware Virtual Disk Development Kit

Weitere Informationen zur vProxy-Protokollierung und -Erfassung finden Sie im Artikel NVP-vProxy-Triage-Handbuch: NetWorker VMware Protection vProxy – Triage und Protokollübersicht

Anwenden der Service-Debugging-Methode 1:

Diese Methode gilt für vProxy-Version 4.3.x und höher. Es kann verwendet werden, um das Debuggen auf vProxy-Services zu aktivieren (vrapid, vrecoverd, vbackupd, vflrd) enthalten. Mehr Debugging kann für DD Boost-Datenverkehr, VDDK (Virtual Disk Development Kit) und Snapshot-Messaging (falls zutreffend) aktiviert werden.

1. Stellen Sie mithilfe des vProxy-Administratorkontos über SSH eine Verbindung zum vProxy her.
2. Wechseln Sie zum Root-Nutzer:

sudo su -

3. Wechseln Sie zum Verzeichnis bin des vProxy-Agent:

cd /opt/emc/vproxy/bin

4. Führen Sie für den Dienst, der ein Debuggen erfordert, die folgenden Befehle aus:

Backup-Engine: vbackupd

./vProxy_debug.sh -s -d vbackupd -p program -l debug

/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-engine.log

/opt/emc/vrproxy/runtime/logs/vbackupd/BackupVmSession-<session-id>.log
/opt/emc/vrproxy/runtime/logs/recycle/vbackupd/<DATE>/BackupVmSession-<session-id>.log

./vProxy_debug.sh -s -d vbackupd -p ddboost -l all

/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-boost.log

./vProxy_debug.sh -s -d vbackupd -p vddk -l 4

/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-vddk.log

./vProxy_debug.sh -s -d vbackupd -p snapshotmgr -l debug

/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-snapmgr.log

Wiederherstellungs-Engine: vrecoverd

./vProxy_debug.sh -s -d vrecoverd -p program -l debug

/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-engine.log

/opt/emc/vrproxy/runtime/logs/vrecoverd/RecoverVmSession-<session-id>.log
/opt/emc/vrproxy/runtime/logs/recycle/vrecoverd/<DATE>/RecoverVmSession-<session-id>.log

./vProxy_debug.sh -s -d vrecoverd -p ddboost -l all

/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-boost.log

./vProxy_debug.sh -s -d vrecoverd -p vddk -l 4

/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-vddk.log

FLR-Engine: vflrd

./vProxy_debug.sh -s -d vflrd -p program -l debug

/opt/emc/vrproxy/runtime/logs/vflrd/vflrd-engine.log

/opt/emc/vrproxy/runtime/logs/vflr/FlrMountSession-<session-id>.log
Individual FLR Browse Session Logs: /opt/emc/vrproxy/runtime/logs/vflr/FlrBrowseSession-<session-id>.log
Individual FLR Recover Session Logs: /opt/emc/vrproxy/runtime/logs/vflr/FlrRecoverSession-<session-id>.log

/opt/emc/vrproxy/runtime/logs/recycle/vflrd

./vProxy_debug.sh -s -d vflrd -p ddboost -l all

/opt/emc/vrproxy/runtime/logs/vflrd/vflrd-boost.log

REST-Server: vrapid

./vProxy_debug.sh -s -d vrapid -p program -l debug

/opt/emc/vrproxy/runtime/logs/vrapid/vrapid-engine.log

Die obigen Befehle zeigen das Aktivieren des Debuggens. Diese Befehle können erneut ausgeführt werden, indem Sie die -l Option zum Zurücksetzen auf die Standardeinstellung:

Optionen:

• Für das Programmprotokoll:

• Für DD Boost-Protokolle:

• Für VDDK-Protokoll:

• Für das Snapshot Manager-Protokoll:

Anwenden der Service-Debugging-Methode 2 (manuell):

1. Melden Sie sich über SSH oder die Konsole als Administrator bei der vProxy-Appliance an und wechseln Sie zum root-Nutzer:

sudo su -

2. Rufen Sie das systemd Verzeichnis:

cd /usr/lib/systemd/system/ 

3. Öffnen Sie die Servicedatei, die Debug-Einstellungen erfordert, z. B.:

vi vbackupd.service 

4. Lokalisieren Sie die Zeile mit ExecStart= und fügen Sie die gewünschten Debugging-Parameter hinzu:

vbackupd, vrecoverd, vflrd, and vrapid engine debug options: { debug | trace | info | warn } (default "trace")
--program-log-level=option

vbackupd, vrecoverd, and vflrd ddboost debug options: { none | error | warn | info | debug | all } (default "trace")
--boost-log-level=option

vbackupd snapshot manager debug options: { warn | info | trace | debug } (default "trace")
--snapmgr-log-level=option

Display version
--version

Multiple options could be used at once, for example if you needed to debug the vbackupd service, ddboost communication, and snapshot manager logging, the vbackupd.service file would include:
ExecStart=/opt/emc/vproxy/bin/vbackupd --program-log-level=debug --boost-log-level=all --snapmgr-log-level=debug

5. Speichern Sie die Änderungen in der Datei.
6. Laden Sie die Einheitenkonfigurationsdatei neu, indem Sie den folgenden Befehl eingeben:

systemctl daemon-reload

7. Vergewissern Sie sich in der NetWorker Management Console, dass keine Backups ausgeführt werden, und starten Sie dann den vbackupd des NMC-Servers herunter:

systemctl restart vbackupd.service

Der obige Prozess gilt für die Services vrapid, vrecoverd, vbackupd, vflrd.

VDDK-Debuggen wird (manuell) angewendet:

Das Debuggen des VMware Disk Development Kit (VDDK) kann manuell im VixDiskLib.config zu verwenden. Dieses Debugging gilt nur für vbackupd und vrecoverd Problembehandlung. Sie gilt nicht für vflrd.
 

1. Melden Sie sich mit SSH oder der Konsole als AdministratorIn bei der vProxy-Appliance an und wechseln Sie zum root-Nutzer:

sudu su -

2. Bearbeiten Sie die VixDiskLib.config -Datei, die die folgende Zeile enthält:

vi /opt/emc/vproxy/conf/VixDiskLib.config 
vixDiskLib.transport.LogLevel=4

0 = No logging
1 = Errors only
2 = Warnings, and Errors
3 = Important information messages, errors, and warnings
4 = Debug data plus everything else

3. Starten Sie den entsprechenden Service neu:

systemctl restart [service-name].service 

systemctl restart vrecoverd.service

Sobald die Debug-Protokollierung festgelegt wurde, sollte die dem Dienst zugeordnete Protokolldatei DEBUG-Zeilen enthalten.

Setzen Sie nach Abschluss des Debugging-Prozesses die Protokollebene mit dem gleichen Verfahren zurück, indem Sie das Wort "trace" nach dem Gleichheitszeichen anstelle von "debug" verwenden. Damit diese Änderung sofort angewendet werden kann, muss der Daemon neu geladen und neu gestartet werden, wie oben beschrieben.

DD Boost-Precert-Debugging:

Dieser Prozess wird mit anderen oben beschriebenen Debugging-Methoden durchgeführt. Die DD Boost-Bibliothek protokolliert standardmäßig keine detaillierten API-Aktivitäten (Application Programming Interface). Die Aktivierung der DD Boost-Vorabzertprotokollierung sollte nur erfolgen, wenn Sie andere DD Boost-bezogene Fehler in der vbackupd-boost.log, vrecovered-boost.log, vflrd-boost.log Dateien und zusätzliches Debugging ist erforderlich. Dies ist in der Regel nur erforderlich, wenn es direkt vom NetWorker-Support für Data-Domain-Kooperationen oder Engineering-Projekte angefordert wird.

1. Melden Sie sich mit SSH oder der Konsole als AdministratorIn bei der vProxy-Appliance an und wechseln Sie zum root-Nutzer:

sudu su -

2. Erstellen Sie eine leere Datei mit dem Namen ddboost_precert.ini unter /verwalten:

touch /ddboost_precert.ini

3. Erstellen Sie die DDLog Verzeichnis:

mkdir /DDLog

4. Aktivieren Sie das DD Boost-Debug für den Service, der ein Debuggen erfordert:

vbackupd: /opt/emc/vproxy/bin/vProxy_debug.sh -s -d vbackupd -p ddboost -l debug

vflrd: /opt/emc/vproxy/bin/vProxy_debug.sh -s -d vflrd -p ddboost -l debug

vrecoverd: /opt/emc/vproxy/bin/vProxy_debug.sh -s -d vrecoverd -p ddboost -l debug

5. Vergewissern Sie sich, dass das ddboost_precert.log generiert wird, reproduzieren Sie das Problem und sammeln Sie die ddboost_precert.logverwalten:

ls -l /DDLog

6. Wenn Debug-Vorgänge nicht mehr erforderlich sind:
   1. Führen Sie den folgenden Befehl erneut für den Dienst aus, für den Sie ddboost debug aktiviert haben:

/opt/emc/vproxy/bin/vProxy_debug.sh -s -d service_name -p ddboost -l trace

1. 2. Löschen Sie die Datei /ddboost_precert.ini zu verwenden.

rm -rf /ddboost_precert.ini

Protokollierung der vProxy-Auswahl:

Dieses Debugging kann immer dann verwendet werden, wenn ein Backupworkflow einer virtuellen Maschine (VM) mit den VMs im Status "Waiting to Run" hängen bleibt. In diesem Szenario wurde der Backupjob gestartet, aber es wurde kein vProxy aufgenommen, um die Backupsitzung zu starten. Bei der Standardprotokollierung findet keine Protokollierung des vProxy-Auswahlprozesses statt. Wir können vmbackup_logging auf dem NetWorker-Server, der den vProxy-Auswahlprozess während des Starts der VMware Protection Policy protokolliert. Dies ist nützlich, wenn keine Kommunikationsprobleme zwischen dem NetWorker-Server und vProxy (Port 9090) vorliegen und keine Fehler vorliegen, dass der vProxy in der NMC oder daemon.raw.

1. Öffnen Sie eine administrative PowerShell-Eingabeaufforderung (Windows) oder eine Root-SSH-Sitzung (Linux) auf dem NetWorker-Server.
2. Erstellen Sie eine Datei ohne die Erweiterung mit dem Namen vmbackup_logging unter dem NetWorker-Befehl /nsr/tmp Verzeichnis:

Linux: 
touch /nsr/tmp/vmbackup_logging

Windows: 
New-Item -Path "C:\Program Files\EMC NetWorker\nsr\tmp\vmbackup_logging" -ItemType File

3. Starten Sie den VM-Backupjob.
4. Überwachen der gerenderten daemon.log für Vmproxy Queue und select_vproxy Nachrichten.

Linux: /nsr/logs/daemon.log
Windows: C:\Program Files\EMC NetWorker\nsr\logs\daemon.log

5. Um dieses Debugging zu deaktivieren, löschen Sie das vmbackup_logging Datei aus dem /nsr/tmp dir.

Zugehörige Artikel:

• NVP-vProxy – Triage-Handbuch: NetWorker VMware Protection vProxy – Triage und Protokollübersicht
• NVP-vProxy: So erhalten Sie die genaue Befehlssyntax zum Ausführen einer VM-Recovery über die CLI mit debug.
• NetWorker (Linux): Kopieren von Dateien zu/von einem Linux NetWorker-Server.
• NVP-vProxy: Troubleshooting der Netzwerkverbindung bei Backup- und Wiederherstellungsvorgängen
• NetWorker: NVP-vProxy – Troubleshooting der VM-Backup- und -Wiederherstellungsperformance und des VM-Durchsatzes