Regardez cette vidéo : Activation de la journalisation du débogage vProxy.
En général, il suffit d’analyser les journaux de politique du NetWorker Server dans
/nsr/logs/policy/[policy name]
, mais il peut parfois être nécessaire d’analyser les logs à partir de l’appliance vProxy elle-même et, en outre, d’augmenter le niveau de journalisation à
déboguer afin d’avoir une idée plus claire de la raison d’une défaillance. Il ne s’agit généralement d’une exigence qu’une fois que le support NetWorker a été engagé et que l’ingénieur du support a demandé un ensemble de débogages pour le dépannage en tant que processus spécifique.
Les fichiers journaux NVP-vProxy sur l’appliance vProxy se trouvent dans le répertoire suivant :
/opt/emc/vproxy/runtime/logs
.
Il existe un sous-répertoire pour chacun des processus principaux utilisés pour les opérations NetWorker sur l’appliance vProxy :
vbackupd
vflrd
vrapid
vrecoverd
Par exemple, dans l'
vbackupd
sous-répertoire, vous avez les journaux :
[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
Vous trouverez des informations supplémentaires sur la journalisation et la collecte vProxy dans l’article
Guide de triage NVP-vProxy : Présentation du tri et du journal NetWorker VMware Protection vProxy
Application de la méthode de débogage de service 1 :
Cette méthode s’applique aux versions 4.3.x et ultérieures de vProxy. Il peut être utilisé pour activer le
débogage sur les services vProxy (
vrapid, vrecoverd, vbackupd, vflrd
). Un débogage supplémentaire peut être activé pour le trafic DD Boost, le VDDK et la messagerie de snapshot (le cas échéant).
- Connectez-vous à vProxy via SSH à l’aide du compte administrateur vProxy.
- Passez à l’utilisateur root :
sudo su -
- Rendez-vous dans le répertoire bin de l’agent vProxy :
cd /opt/emc/vproxy/bin
- Pour le service que vous souhaitez déboguer, exécutez les commandes suivantes :
Moteur de sauvegarde : vbackupd
Démon |
Entité de journalisation |
Exemple d’utilisation des commandes |
Emplacements des journaux |
vbackupd |
Programme (moteur principal) |
./vProxy_debug.sh -s -d vbackupd -p program -l debug |
/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-engine.log Logs de session de sauvegarde individuels : /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 Le VDDK conserve également des journaux privés dans le répertoire /tmp/vmware-root |
|
Gestionnaire de snapshots |
./vProxy_debug.sh -s -d vbackupd -p snapshotmgr -l debug |
/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-snapmgr.log |
Restaurer le moteur : vrecoverd
Démon |
Entité de journalisation |
Exemple d’utilisation des commandes |
Emplacements des journaux |
vrecoverd |
Programme (entité principale) |
./vProxy_debug.sh -s -d vrecoverd -p program -l debug |
/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-engine.log Logs individuels des sessions de restauration : /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 Le VDDK gère également les journaux privés dans le répertoire /tmp/vmware-root |
Moteur FLR : vflrd
Démon |
Entité de journalisation |
Exemple d’utilisation des commandes |
Emplacement du journal |
vflrd |
Programme (moteur principal) |
./vProxy_debug.sh -s -d vflrd -p program -l debug |
/opt/emc/vrproxy/runtime/logs/vflrd/vflrd-engine.log Journaux de session de montage FLR individuels : /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 Les journaux terminés sont déplacés vers /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 Le VDDK gère également les journaux privés dans le répertoire /tmp/vmware-root |
Serveur REST : vrapid
Démon |
Entité de journalisation |
Exemple d’utilisation des commandes |
Emplacement du journal |
vrapid |
Programme (moteur principal) |
./vProxy_debug.sh -s -d vrapid -p program -l debug |
/opt/emc/vrproxy/runtime/logs/vrapid/vrapid-engine.log |
Les commandes ci-dessus montrent l’activation du débogage. Ces commandes peuvent être réexécutées en modifiant le paramètre
-l
option de réinitialisation à la valeur par défaut :
Options :
- Pour le journal du programme :
warn
| info
| trace
(par défaut) | debug
- Pour le journal DD Boost :
none
| error
| warn
| info
| debug
| trace
(par défaut) | all
0
= Pas de journalisation
1
= Erreurs uniquement
2
= avertissements et erreurs
3
= messages d’information importants, erreurs et avertissements (par défaut)
4
= Données de débogage et tout le reste
- Pour le journal Snapshot Manager :
warn
| info
| trace
(par défaut) | debug
Application de la méthode de débogage de service 2 :
Les niveaux de journalisation disponibles sont none, error, warn, info, trace et debug.
Afin de définir l’attribut vbackupd
Processus de débogage au niveau de journalisation :
- Connectez-vous à l’appliance vProxy en tant qu’administrateur via SSH ou la console, puis passez à l’utilisateur root :
sudo su -
- Rendez-vous sur le
systemd
répertoire:
cd /usr/lib/systemd/system/
Remarque : Chacun des fichiers de service se trouve ici : vbackupd.service, vfrld.service, vrapid.service, vrecoverd.service,
etc.
- Ouvrez le fichier de service sur lequel vous souhaitez appliquer le débogage, par exemple :
vi vbackupd.service
- Localisez la ligne avec
ExecStart=
et ajoutez avec --program-log-level=debug
Autres paramètres :
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
Remarque : La version NVP-vProxy s’affiche dans l’onglet Configuration des propriétés vProxy dans NetWorker Management Console >Devices > VMware Proxies > Cliquez avec le bouton droit de la souris sur vProxy appliance >Properties Configuration >> VM Proxy version.
- Enregistrez les modifications apportées au fichier
- Rechargez le fichier de configuration de l’unité en saisissant la commande suivante :
systemctl daemon-reload
- Dans NetWorker Management Console, vérifiez qu’aucune sauvegarde n’est en cours d’exécution, puis redémarrez le
vbackupd
service:
systemctl restart vbackupd.service
Le processus ci-dessus s’applique aux services
vrapid, vrecoverd, vbackupd, vflrd.
Application du débogage VDDK :
- Connectez-vous en tant qu’administrateur à l’appliance vProxy à l’aide de SSH ou de la console, puis passez à l’utilisateur root :
sudu su -
- Modifiez le fichier VixDiskLib.config pour qu’il contienne la ligne suivante :
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
- Redémarrez le service concerné :
systemctl restart [service-name].service
Par exemple :
systemctl restart vrecoverd.service
Une fois que vous avez défini le niveau de journalisation du débogage, vous pouvez confirmer qu’il existe des messages dans le fichier journal concerné qui commencent par le mot
Debug.
Une fois le processus de débogage terminé, vous pouvez réinitialiser le niveau de journalisation à l’aide de la même procédure, en utilisant le mot
trace après le signe égal au lieu de
debug. Pour que cette modification s’applique immédiatement, un rechargement et un redémarrage du processus sont requis, comme indiqué ci-dessus.
Débogage DD Boost Precert :
Ce processus est effectué avec d’autres méthodes de débogage décrites ci-dessus.
- Connectez-vous en tant qu’administrateur à l’appliance vProxy à l’aide de SSH ou de la console, puis passez à l’utilisateur root :
sudu su -
- Créer un fichier
ddboost_precert.ini
sous:
/: touch /ddboost_precert.ini
- Créez le fichier
DDLog
répertoire:
mkdir /DDLog
- Activez le débogage DD Boost pour le service que vous souhaitez déboguer :
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
- Vérifiez que l’option
ddboost_precert.log
est généré :
ls -l /DDLog
- Lorsque les opérations de débogage ne sont plus nécessaires, exécutez à nouveau la commande suivante :
vProxy_debug.sh -l trace
Journalisation de la sélection vProxy :
Ce débogage peut être utilisé chaque fois qu’un workflow de sauvegarde de machine virtuelle est bloqué avec les machines virtuelles en
attente d’exécution. Dans ce scénario, la procédure de sauvegarde a démarré, mais aucun vProxy n’a été récupéré pour démarrer la session de sauvegarde. Il n’y a pas de journalisation du processus de sélection vProxy dans la journalisation standard. Nous pouvons activer
vmbackup_logging
sur le NetWorker Server, qui consigne le processus de sélection vProxy lors du démarrage de la politique de protection VMware. Cela peut être utile en l’absence de problème de communication entre NetWorker Server et vProxy (port 9090) et qu’il n’y a pas d’erreur concernant l’indisponibilité du vProxy dans NMC ou daemon.log.
- Ouvrez une invite d’administration PowerShell (Windows) ou une session SSH root (Linux) sur le NetWorker Server.
- Créez un fichier sans extension appelé
vmbackup_logging
sous NetWorker /nsr/tmp
répertoire:
Linux:
touch /nsr/tmp/vmbackup_logging
Windows:
New-Item -Path "C:\Program Files\EMC NetWorker\nsr\tmp\vmbackup_logging" -ItemType File
La commande ci-dessus suppose que l’emplacement d’installation par défaut de NetWorker a été utilisé. Si NetWorker a été installé à un autre emplacement, ajustez l’emplacement de /nsr/tmp
en conséquence.
- Démarrez la procédure de sauvegarde de la machine virtuelle.
- Surveillez les daemon.log rendus pour la file d’attente Vmproxy et sélectionnez les messages vproxy.
Linux: /nsr/logs/daemon.log
Windows: C:\Program Files\EMC NetWorker\nsr\logs\daemon.log
- Pour désactiver ce débogage, supprimez le fichier vmbackup_logging du fichier
/nsr/tmp
Dir.