NetWorker VMware Protection-vProxy: Aktivieren der Debug-Protokollierung

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

Methoden zum Anwenden des vProxy-Engine-Debugs:

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

NVP-vProxy-Protokolldateien auf der vProxy-Appliance befinden sich im folgenden Verzeichnis: /opt/emc/vproxy/runtime/logsEs gibt ein Unterverzeichnis für jeden der Hauptprozesse, die für NetWorker-Vorgänge auf der vProxy-Appliance verwendet werden:

vbackupd

vflrd

vrapid

vrecoverd

Zum Beispiel ist der vbackupd 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 folgenden 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.1. Sie kann verwendet werden, um das Debuggen auf vProxy-Services (vrapid, vrecoverd, vbackupd, vflrd). Mehr Debugging kann für DD Boost-Datenverkehr, Virtual Disk Development Kit (VDDK) und Snapshot-Messaging (falls zutreffend) aktiviert werden.

1. Stellen Sie eine Verbindung zum vProxy über SSH über das vProxy-Konto admin her.2.
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 Service, der 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 Debuggen. Diese Befehle können erneut ausgeführt werden, um die -l Option zum Zurücksetzen auf die Standardeinstellung:

Optionen:

• Für das Programmprotokoll:

• Für DD Boost-Protokoll:

• Für VDDK-Protokoll:

• Für Snapshot Manager-Protokoll:

Anwenden der Service-Debugging-Methode 2:

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

sudo su -

2. Rufen Sie Folgendes auf: systemd Verzeichnis:

cd /usr/lib/systemd/system/ 

3. Öffnen Sie die Servicedatei, für die Debug-Einstellungen erforderlich sind, z. B.:

vi vbackupd.service 

4. Suchen Sie die Linie mit ExecStart= und hängen Sie die gewünschten Debuggingparameter an:

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 Einheitenkonfigurationsdateien mit diesem Befehl neu:

systemctl daemon-reload

7. Bestätigen Sie in der NetWorker Management Console, dass derzeit keine Backups ausgeführt werden, und starten Sie dann den Service vbackupd neu: vbackupd Wartung:

systemctl restart vbackupd.service

systemctl restart vbackupd.serviceDer obige Prozess gilt für die Services: vrapid, vrecoverd, vbackupd, vflrd.

Anwenden des VDDK-Debuggens:

Das Debuggen des VMware Disk Development Kit (VDDK) kann manuell im VixDiskLib.config Datei. Dieses Debugging gilt nur für vbackupd und vrecoverd Troubleshooting fortzufahren. Es gilt nicht für das 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 Die Datei muss die folgende Zeile enthalten:

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 mit dem Service verknüpfte Protokolldatei DEBUG-Zeilen enthalten.

Setzen Sie nach Abschluss des Debuggingprozesses die Protokollebene mithilfe desselben Verfahrens zurück, indem Sie das Wort trace nach dem Gleichheitszeichen anstelle von debug verwenden. Damit dies sofort angewendet werden kann, muss der Daemon neu geladen und neu gestartet werden, wie oben beschrieben.

DD Boost-Vorabzertifikat-Debugging:

Dieser Prozess kann in Kombination mit anderen oben beschriebenen Debuggingmethoden durchgeführt werden.1. Die DD Boost-Bibliothek protokolliert standardmäßig keine detaillierten API-Aktivitäten (Application Programming Interface). Das Aktivieren der DD Boost-Vorabprotokollierung sollte nur erfolgen, wenn Sie andere DD Boost-bezogene Fehler im vbackupd-boost.log, vrecovered-boost.log, vflrd-boost.log Dateien und zusätzliches Debugging sind erforderlich. Dies ist in der Regel nur erforderlich, wenn dies direkt vom NetWorker-Support für Data-Domain-Kollaborationen 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 die ddboost_precert.ini unter /: 

vi /ddboost_precert.ini

Fügen Sie Folgendes zur Datei hinzu:

precert_enabled=true
num_log_files=4
log_file_size=512
log_file_name=ddboost_precert.log
log_file_dir=/DDLog
ddcl_logs_include=true
ddcl_logs_sev=3

3. Erstellen Sie die DDLog Verzeichnis:

mkdir /DDLog ; chmod 755 /DDLog

4. Aktivieren Sie das DD Boost-Debuggen für den Service, der 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 Attribut ddboost_precert.log erzeugt wird, reproduzieren Sie das Problem und erfassen Sie die ddboost_precert.log:

ls -l /DDLog

6. Verwenden Sie precert-io-perf.py So analysieren Sie die ddboost_precert.log Dateien: NetWorker: Analysieren der I/O-Performance mithilfe von ddboost_precert.log
7. Wenn Debug-Vorgänge nicht mehr erforderlich sind:
   1. Führen Sie den folgenden Befehl erneut für den Service 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 /ddboost_precert.ini Datei.

rm -rf /ddboost_precert.ini

Protokollierung der vProxy-Auswahl:

Dieses Debugging kann immer dann verwendet werden, wenn ein Backupworkflow einer virtuellen Maschine (VM) hängen bleibt und die VMs auf die Ausführung warten. In diesem Szenario wurde der Backupjob gestartet, aber es wurde kein vProxy ausgewählt, um die Backupsitzung zu starten. Der vProxy-Auswahlprozess wird in der Standardprotokollierung nicht protokolliert. Wir ermöglichen vmbackup_logging auf dem NetWorker-Server, der den vProxy-Auswahlprozess während des Starts der VMware Protection Policy protokolliert. Dies ist nützlich, wenn es keine Kommunikationsprobleme zwischen dem NetWorker-Server und vProxy (Port 9090) gibt und keine Fehler vorliegen, dass der vProxy in NMC oder daemon.raw.

1. Öffnen Sie eine PowerShell-Eingabeaufforderung für die Verwaltung (Windows) oder eine SSH-Root-Sitzung (Linux) auf dem NetWorker-Server.
2. Erstellen Sie eine Datei ohne Erweiterung mit dem Namen vmbackup_logging unter NetWorker /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 auf Vmproxy Queue und select_vproxy Meldungen

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

5. Um dieses Debugging zu deaktivieren, löschen Sie die vmbackup_logging Datei aus dem /nsr/tmp Regie:

Debugging der vProxy-Benutzeroberfläche:

• NVP-vProxy: Data Protection Restore Client (DPRC) – Troubleshooting-Handbuch
• NVP-vProxy: vCenter Plug-in und Benutzeroberfläche (VCUI) – Troubleshooting

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 für Backup- und Wiederherstellungsvorgänge
• NetWorker: NVP vProxy – Troubleshooting VM-Backup- und Wiederherstellungsperformance und -durchsatz