NetWorker VMware Protection-vProxy : Activation de la journalisation de débogage

Summary: Il peut être nécessaire de passer le niveau de journalisation à « debug » pour résoudre un problème lié à NetWorker VMware Protection (NVP) avec la solution vProxy Appliance (NVP-vProxy). Cet article explique comment modifier le niveau de journalisation. ...

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Instructions

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).
  1. Connectez-vous à vProxy via SSH à l’aide du compte administrateur vProxy.
  2. Passez à l’utilisateur root :
sudo su -
  1. Rendez-vous dans le répertoire bin de l’agent vProxy :
cd /opt/emc/vproxy/bin
  1. 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
  • Pour le journal VDDK :
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 :
  1. Connectez-vous à l’appliance vProxy en tant qu’administrateur via SSH ou la console, puis passez à l’utilisateur root :
sudo su -
  1. 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.
  1. Ouvrez le fichier de service sur lequel vous souhaitez appliquer le débogage, par exemple :
vi vbackupd.service 
  1. 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.
 
  1. Enregistrez les modifications apportées au fichier
  2. Rechargez le fichier de configuration de l’unité en saisissant la commande suivante :
systemctl daemon-reload
  1. 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 :

  1. Connectez-vous en tant qu’administrateur à l’appliance vProxy à l’aide de SSH ou de la console, puis passez à l’utilisateur root :
sudu su -
  1. 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
  1. 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.
  1. Connectez-vous en tant qu’administrateur à l’appliance vProxy à l’aide de SSH ou de la console, puis passez à l’utilisateur root :
sudu su -
  1. Créer un fichier ddboost_precert.ini sous:
/: touch /ddboost_precert.ini
  1. Créez le fichier DDLog répertoire:
mkdir /DDLog
  1. 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
  1. Vérifiez que l’option ddboost_precert.log est généré :
ls -l /DDLog
​​​​​​ Capture d’écran de la confirmation du journal
  1. 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.
 
  1. Ouvrez une invite d’administration PowerShell (Windows) ou une session SSH root (Linux) sur le NetWorker Server.
  2. 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.
  1. Démarrez la procédure de sauvegarde de la machine virtuelle.
  2. 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
Si vous avez des questions, consultez l’article : NetWorker : utilisation de nsr_render_log.
  1. Pour désactiver ce débogage, supprimez le fichier vmbackup_logging du fichier /nsr/tmp Dir.

Additional Information

Articles connexes :

Affected Products

NetWorker

Products

NetWorker, NetWorker Series
Article Properties
Article Number: 000022610
Article Type: How To
Last Modified: 11 Mar 2025
Version:  16
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.