Sehen Sie sich dieses Video an: So aktivieren Sie die vProxy-Debug-Protokollierung.
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/logs
aus.
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
Zum Beispiel in der
vbackupd
Unterverzeichnis haben Sie die 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
3. 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
). Mehr Debugging kann für DD Boost-Datenverkehr, VDDK und Snapshot-Messaging (falls zutreffend) aktiviert werden.
- Stellen Sie mithilfe des vProxy-Administratorkontos über SSH eine Verbindung zum vProxy her.
- Wechseln Sie zum Root-Nutzer:
sudo su -
- Wechseln Sie zum Verzeichnis bin des vProxy-Agent:
cd /opt/emc/vproxy/bin
- Führen Sie für den Service, den Sie debuggen möchten, die folgenden Befehle aus:
Backup-Engine: vbackupd
Dämon |
Protokollierungsentität |
Beispiel für die Verwendung von Befehlen |
Protokollspeicherorte |
vbackupd |
Programm (Haupt-Engine) |
./vProxy_debug.sh -s -d vbackupd -p program -l debug |
/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-engine.log Einzelne Backupsitzungsprotokolle: /opt/emc/vrproxy/runtime/logs/vbackupd/BackupVmSession-<session-id>.log
/opt/emc/vrproxy/runtime/logs/recycle/vbackupd/<DATE>/BackupVmSession-<session-id>.log |
|
DD Boost |
./vProxy_debug.sh -s -d vbackupd -p ddboost -l all |
/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-boost.log |
|
VDDK |
./vProxy_debug.sh -s -d vbackupd -p vddk -l 4 |
/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-vddk.log Das VDDK verwaltet auch private Protokolle im Verzeichnis /tmp/vmware-root |
|
Snapshot-Manager |
./vProxy_debug.sh -s -d vbackupd -p snapshotmgr -l debug |
/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-snapmgr.log |
Wiederherstellungs-Engine: vrecoverd
Dämon |
Protokollierungsentität |
Beispiel für die Verwendung von Befehlen |
Protokollspeicherorte |
vrecoverd |
Programm (Haupteinheit) |
./vProxy_debug.sh -s -d vrecoverd -p program -l debug |
/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-engine.log Einzelne Protokolle der Wiederherstellungssitzung: /opt/emc/vrproxy/runtime/logs/vrecoverd/RecoverVmSession-<session-id>.log
/opt/emc/vrproxy/runtime/logs/recycle/vrecoverd/<DATE>/RecoverVmSession-<session-id>.log |
|
DD Boost |
./vProxy_debug.sh -s -d vrecoverd -p ddboost -l all |
/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-boost.log |
|
VDDK |
./vProxy_debug.sh -s -d vrecoverd -p vddk -l 4 |
/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-vddk.log Das VDDK verwaltet auch private Protokolle im Verzeichnis /tmp/vmware-root |
FLR-Engine: vflrd
Dämon |
Protokollierungsentität |
Beispiel für die Verwendung von Befehlen |
Protokollspeicherort |
vflrd |
Programm (Haupt-Engine) |
./vProxy_debug.sh -s -d vflrd -p program -l debug |
/opt/emc/vrproxy/runtime/logs/vflrd/vflrd-engine.log Einzelne FLR-Mount-Sitzungsprotokolle: /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 Abgeschlossene Protokolle werden verschoben nach /opt/emc/vrproxy/runtime/logs/recycle/vflrd |
|
DD Boost |
./vProxy_debug.sh -s -d vflrd -p ddboost -l all |
/opt/emc/vrproxy/runtime/logs/vflrd/vflrd-boost.log |
|
VDDK |
./vProxy_debug.sh -s -d vflrd -p vddk -l 4 |
/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-vddk.log Das VDDK verwaltet auch private Protokolle im Verzeichnis /tmp/vmware-root |
REST-Server: vrapid
Dämon |
Protokollierungsentität |
Beispiel für die Verwendung von Befehlen |
Protokollspeicherort |
vrapid |
Programm (Haupt-Engine) |
./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:
warn
| info
| trace
(Standardeinstellung) | debug
none
| error
| warn
| info
| debug
| trace
(Standardeinstellung) | all
0
= Keine Protokollierung
1
= Nur Fehler
2
= Warnungen und Fehler
3
= wichtige Informationsmeldungen, Fehler und Warnungen (Standard)
4
= Debug-Daten plus alles andere
- Für das Snapshot Manager-Protokoll:
warn
| info
| trace
(Standardeinstellung) | debug
Anwenden der Service-Debugging-Methode 2:
Die verfügbaren Protokollierungsebenen sind "none", "error", "warn", "info", "trace" und "debug".
Um die vbackupd
Prozess in Protokollierungslevel-Debugging:
- Melden Sie sich über SSH oder die Konsole als Administrator bei der vProxy-Appliance an und wechseln Sie zum root-Nutzer:
sudo su -
- Rufen Sie das
systemd
Verzeichnis:
cd /usr/lib/systemd/system/
Hinweis: Die einzelnen Servicedateien finden Sie hier: vbackupd.service, vfrld.service, vrapid.service, vrecoverd.service,
und so weiter
- Öffnen Sie die Servicedatei, auf die Sie das Debuggen anwenden möchten, z. B.:
vi vbackupd.service
- Lokalisieren Sie die Zeile mit
ExecStart=
und hängen Sie mit --program-log-level=debug
Andere Parameter:
vProxy 2.x engine log level: { debug, trace, info, warn }.
--engine-log-level=string
vProxy 3.x and later engine level: { debug, trace, info, warn } (default "trace")
--program-log-level=string (vbackupd)
Display version
--version
Hinweis: Die NVP-vProxy-Version wird auf der Registerkarte Konfiguration der vProxy-Eigenschaften in der NetWorker Management Console >Geräte > VMware Proxys > angezeigt. Klicken Sie mit der rechten Maustaste auf die vProxy-Appliance >Eigenschaften >Konfiguration > VM Proxyversion.
- Speichern Sie die Änderungen in der Datei.
- Laden Sie die Einheitenkonfigurationsdatei neu, indem Sie den folgenden Befehl eingeben:
systemctl daemon-reload
- Vergewissern Sie sich in der NetWorker Management Console, dass keine Backups ausgeführt werden, und starten Sie dann den
vbackupd
Dienst:
systemctl restart vbackupd.service
Der obige Prozess gilt für die Services
vrapid, vrecoverd, vbackupd, vflrd.
Anwenden des VDDK-Debuggens:
- Melden Sie sich mit SSH oder der Konsole als AdministratorIn bei der vProxy-Appliance an und wechseln Sie zum root-Nutzer:
sudu su -
- Bearbeiten Sie die Datei VixDiskLib.config so, dass sie 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
- Starten Sie den entsprechenden Service neu:
systemctl restart [service-name].service
Zum Beispiel:
systemctl restart vrecoverd.service
Nachdem Sie die Debug-Protokollierungsebene festgelegt haben, können Sie bestätigen, dass in der entsprechenden Protokolldatei Meldungen vorhanden sind, die mit dem Wort
Debug beginnen.
Nach Abschluss des Debugging-Prozesses können Sie die Protokollebene mit dem gleichen Verfahren zurücksetzen, 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.
- Melden Sie sich mit SSH oder der Konsole als AdministratorIn bei der vProxy-Appliance an und wechseln Sie zum root-Nutzer:
sudu su -
- Erstellen einer Datei
ddboost_precert.ini
unter:
/: touch /ddboost_precert.ini
- Erstellen Sie die
DDLog
Verzeichnis:
mkdir /DDLog
- Aktivieren Sie das DD Boost-Debuggen für den Service, den Sie debuggen möchten:
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
- Vergewissern Sie sich, dass das
ddboost_precert.log
wird erzeugt:
ls -l /DDLog
- Wenn Debug-Vorgänge nicht mehr erforderlich sind, führen Sie den folgenden Befehl erneut aus:
vProxy_debug.sh -l trace
Protokollierung der vProxy-Auswahl:
Dieses Debugging kann immer dann verwendet werden, wenn ein VM-Backupworkflow hängen bleibt und sich die VMs im
Zustand "Waiting to Run" befinden. 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 kann nützlich sein, wenn kein Kommunikationsproblem zwischen dem NetWorker-Server und vProxy (Port 9090) vorliegt und keine Fehler vorliegen, die darauf hinweisen, dass der vProxy in der NMC oder daemon.log nicht verfügbar ist.
- Öffnen Sie eine administrative PowerShell-Eingabeaufforderung (Windows) oder eine Root-SSH-Sitzung (Linux) auf dem NetWorker-Server.
- 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
Beim obigen Befehl wird davon ausgegangen, dass das NetWorker-Standardinstallationsverzeichnis verwendet wurde. Wenn NetWorker unter einem anderen Speicherort installiert wurde, passen Sie den Speicherort von /nsr/tmp
entsprechend.
- Starten Sie den VM-Backupjob.
- Überwachen Sie die gerenderten daemon.log für die VMwareroxy-Warteschlange und wählen Sie vproxy-Nachrichten aus.
Linux: /nsr/logs/daemon.log
Windows: C:\Program Files\EMC NetWorker\nsr\logs\daemon.log
- Um dieses Debugging zu deaktivieren, löschen Sie die vmbackup_logging Datei aus dem
/nsr/tmp
dir.