NetWorker VMware Protection — vProxy: Włączanie rejestrowania debugowania

Obejrzyj ten film: Jak włączyć rejestrowanie debugowania vProxy.

Metody stosowania debugowania silnika vProxy:

Zazwyczaj wystarczy przeanalizować dzienniki zasad serwera NetWorker w /nsr/logs/policy/[policy name], ale czasami może być konieczne przeanalizowanie dzienników z samego urządzenia vProxy, a ponadto zwiększenie poziomu rejestrowania do debugowania, aby lepiej zrozumieć przyczynę awarii. Zazwyczaj jest to wymagane tylko po kontakcie z pomocą techniczną NetWorker, a inżynier pomocy technicznej poprosił o ustawienie debugowania w celu rozwiązania problemów z określonym procesem. 

Pliki dzienników NVP-vProxy na urządzeniu vProxy znajdują się w następującym katalogu /opt/emc/vproxy/runtime/logs.

Istnieje podkatalog dla każdego z głównych procesów, które są używane do operacji NetWorker na urządzeniu vProxy:

vbackupd

vflrd

vrapid

vrecoverd

Na przykład vbackupd Podkatalog zawiera następujące dzienniki:

[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

Dodatkowe informacje na temat rejestrowania i zbierania vProxy można znaleźć w artykule NVP-vProxy Triage Guide: NetWorker VMware Protection vProxy — przegląd klasyfikacji i dzienników

Zastosowanie metody debugowania usługi 1:

Ta metoda dotyczy wersji vProxy: 4.3.x i nowszych. Można go użyć do włączenia debugowania usług vProxy (vrapid, vrecoverd, vbackupd, vflrd). Można włączyć więcej debugowania dla ruchu DD Boost, Virtual Disk Development Kit (VDDK) i komunikatów migawek (jeśli ma to zastosowanie).

1. Połącz się z vProxy przez SSH przy użyciu konta administratora vProxy.
2. Przełącz się do katalogu głównego:

sudo su -

3. Zmień na katalog bin agenta vProxy.

cd /opt/emc/vproxy/bin

4. W przypadku usługi wymagającej debugowania uruchom następujące polecenia:

Silnik tworzenia kopii zapasowych: 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

Silnik odzyskiwania: 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

Silnik FLR: 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

Serwer REST: vrapid

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

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

Powyższe polecenia pokazują włączanie debugowania, te polecenia można uruchomić ponownie, zmieniając -l opcja przywrócenia wartości domyślnych:

Opcje:

• Dla dziennika programu:

• W przypadku dziennika DD Boost:

• Dla dziennika VDDK:

• W przypadku dziennika Snapshot Manager:

Zastosowanie metody debugowania usługi 2 (ręcznie):

1. Zaloguj się do urządzenia vProxy jako administrator przez SSH lub konsolę i przełącz się do katalogu głównego:

sudo su -

2. Przejdź do systemd Katalogu:

cd /usr/lib/systemd/system/ 

3. Otwórz plik usługi, który wymaga ustawień debugowania, na przykład:

vi vbackupd.service 

4. Zlokalizuj wiersz za pomocą ExecStart= i dodaj żądane parametry debugowania:

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. Zapisz zmiany w pliku
6. Załaduj ponownie plik konfiguracyjny urządzenia, wpisując polecenie:

systemctl daemon-reload

7. Sprawdź w konsoli NetWorker Management Console, czy nie są uruchomione żadne kopie zapasowe, a następnie uruchom ponownie vbackupd NMC:

systemctl restart vbackupd.service

Powyższy proces ma zastosowanie do usług vrapid, vrecoverd, vbackupd, vflrd.

Stosowanie debugowania VDDK (ręcznie):

Debugowanie zestawu VMware Disk Development Kit (VDDK) można zastosować ręcznie w VixDiskLib.config programu NetWorker. To debugowanie dotyczy tylko vbackupd i vrecoverd Rozwiązywanie problemów. Nie ma ona zastosowania do vflrd.
 

1. Zaloguj się do urządzenia vProxy za pomocą SSH lub konsoli jako administrator i przełącz się do katalogu głównego:

sudu su -

2. Edytuj plik VixDiskLib.config , aby zawierał następujący wiersz:

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. Uruchom ponownie odpowiednią usługę:

systemctl restart [service-name].service 

systemctl restart vrecoverd.service

Po ustawieniu rejestrowania debugowania plik dziennika skojarzony z usługą powinien zawierać wiersze DEBUG.

Po zakończeniu procesu debugowania zresetuj poziom dziennika przy użyciu tej samej procedury, używając słowa trace po znaku równości zamiast debugowania. Aby ta zmiana została natychmiast zastosowana, wymagane jest ponowne załadowanie i ponowne uruchomienie demona, jak opisano powyżej.

Debugowanie DD Boost Precert:

Ten proces jest wykonywany przy użyciu innych metod debugowania opisanych powyżej. Biblioteka DD Boost domyślnie nie rejestruje szczegółowej aktywności interfejsu programowania aplikacji (API). Włączenie rejestrowania DD Boost precert powinno być wykonywane tylko wtedy, gdy obserwujesz inne błędy związane z DD boost w vbackupd-boost.log, vrecovered-boost.log, vflrd-boost.log pliki i potrzebne jest dodatkowe debugowanie. Jest to zwykle wymagane tylko wtedy, gdy zażąda tego bezpośrednio pomoc techniczna NetWorker w zakresie współpracy w zakresie Data Domain lub zleceń inżynieryjnych.

1. Zaloguj się do urządzenia vProxy za pomocą SSH lub konsoli jako administrator i przełącz się do katalogu głównego:

sudu su -

2. Utwórz pusty plik o nazwie ddboost_precert.ini w obszarze /:

touch /ddboost_precert.ini

3. Utwórz plik DDLog Katalogu:

mkdir /DDLog

4. Włącz debugowanie DD Boost dla usługi wymagającej debugowania:

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. Potwierdź, że ddboost_precert.log jest generowany, odtwórz problem i zbierz ddboost_precert.log:

ls -l /DDLog

6. Gdy operacje debugowania nie są już wymagane:
   1. Uruchom ponownie następujące polecenie dla usługi, dla której włączono ddboost debug:

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

1. 2. Usuń filtr /ddboost_precert.ini programu NetWorker.

rm -rf /ddboost_precert.ini

Rejestrowanie wyboru vProxy:

Tego debugowania można użyć za każdym razem, gdy przepływ pracy tworzenia kopii zapasowej maszyny wirtualnej (VM) utknie z maszynami wirtualnymi oczekującymi na uruchomienie. W tym scenariuszu zadanie tworzenia kopii zapasowej zostało rozpoczęte, ale nie pobrano żadnego serwera vProxy w celu uruchomienia sesji tworzenia kopii zapasowej. Proces wyboru vProxy nie jest rejestrowany w rejestrowaniu standardowym. Możemy włączyć vmbackup_logging na serwerze NetWorker, który rejestruje proces wyboru vProxy podczas uruchamiania polityki ochrony VMware. Jest to przydatne, gdy nie ma problemów z komunikacją między serwerem NetWorker a vProxy (port 9090) i nie ma błędów związanych z niedostępnością vProxy w NMC lub daemon.raw.

1. Otwórz administracyjny wiersz poleceń programu PowerShell (Windows) lub główną sesję SSH (Linux) na serwerze NetWorker.
2. Utwórz plik bez rozszerzenia o nazwie vmbackup_logging w obszarze NetWorker /nsr/tmp Katalogu:

Linux: 
touch /nsr/tmp/vmbackup_logging

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

3. Uruchom zadanie tworzenia kopii zapasowej maszyny wirtualnej.
4. Monitoruj renderowane daemon.log pod kątem Vmproxy Queue i select_vproxy Wiadomości.

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

5. Aby wyłączyć to debugowanie, usuń vmbackup_logging plik z pliku /nsr/tmp Dir.

Powiązane artykuły:

• Podręcznik weryfikacji NVP-vProxy: NetWorker VMware Protection vProxy — przegląd klasyfikacji i dzienników
• NVP vProxy: Jak uzyskać dokładną składnię polecenia do uruchamiania odzyskiwania maszyny wirtualnej z interfejsu wiersza polecenia z debugowaniem.
• NetWorker (Linux): Kopiowanie plików do/z serwera Linux NetWorker.
• NVP vProxy: rozwiązywanie problemów z łącznością sieciową dla operacji tworzenia kopii zapasowych i przywracania
• NetWorker: NVP vProxy — rozwiązywanie problemów z tworzeniem kopii zapasowych i przywracaniem maszyn wirtualnych — wydajność i przepustowość