NetWorker VMware Protection-vProxy: Cómo habilitar el registro de depuración
Resumen: Es posible que sea necesario cambiar el nivel de registro a "debug" para solucionar un problema con NetWorker VMware Protection (NVP) con la solución del dispositivo vProxy (NVP-vProxy). En este artículo, se explica cómo cambiar el nivel de registro. ...
Instrucciones
Vea este video: Cómo habilitar el registro de depuración de vProxy.
Métodos para aplicar la depuración del motor vProxy:
Por lo general, es suficiente analizar los registros de políticas de NetWorker Server en /nsr/logs/policy/[policy name], pero ocasionalmente puede ser necesario analizar los registros del propio dispositivo vProxy y, además, aumentar el nivel de registro a depurar para tener una idea más clara del motivo de una falla. Por lo general, esto solo es necesario una vez que se ha contactado al soporte de NetWorker y el ingeniero de soporte ha solicitado establecer la depuración para solucionar problemas como un proceso específico.
Los archivos de registro de NVP-vProxy en el dispositivo vProxy se encuentran en el siguiente directorio: /opt/emc/vproxy/runtime/logs.
Hay un subdirectorio para cada uno de los procesos principales que se utilizan para las operaciones de NetWorker en el dispositivo vProxy:
vbackupd vflrd vrapid vrecoverd
Por ejemplo, el método vbackupd El subdirectorio contiene los siguientes registros:
[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
Puede encontrar información adicional sobre el registro y la recopilación de vProxy en el artículo Guía de triage de NVP-vProxy: Visión general de triage y registro de vProxy de NetWorker VMware Protection
Aplicación del método de depuración de servicio 1:
Este método se aplica a la versión 4.3.x y posteriores de vProxy. Se puede utilizar para habilitar la depuración en los servicios de vProxy (vrapid, vrecoverd, vbackupd, vflrd). Se puede habilitar más depuración para el tráfico de DD Boost, el kit de desarrollo de discos virtuales (VDDK) y la mensajería de instantáneas (cuando corresponda).
- Conéctese al vProxy a través de SSH mediante la cuenta de administrador de vProxy.
- Cambie a root:
sudo su -
- Cambie al directorio bin del agente de vProxy:
cd /opt/emc/vproxy/bin
- Para el servicio que requiere depuración, ejecute los siguientes comandos:
Motor de respaldo: vbackupd
| Demonio | Entidad de registro | Ejemplo de uso de comandos | Ubicaciones de logs |
|---|---|---|---|
vbackupd |
Programa (motor principal) |
./vProxy_debug.sh -s -d vbackupd -p program -l debug |
/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-engine.log Registros de sesiones de respaldo individuales: /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.logEl VDDK también mantiene registros privados en el directorio /tmp/vmware-root
|
|
| Administrador de instantáneas |
./vProxy_debug.sh -s -d vbackupd -p snapshotmgr -l debug |
/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-snapmgr.log |
Motor de recuperación: vrecoverd
| Demonio | Entidad de registro | Ejemplo de uso de comandos | Ubicaciones de logs |
|---|---|---|---|
vrecoverd |
Programa (entidad principal) |
./vProxy_debug.sh -s -d vrecoverd -p program -l debug |
/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-engine.log Registros de sesiones de recuperación individuales: /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.logEl VDDK también mantiene registros privados en el directorio /tmp/vmware-root
|
Motor de FLR: vflrd
| Demonio | Entidad de registro | Ejemplo de uso de comandos | Ubicación del registro |
|---|---|---|---|
vflrd |
Programa (motor principal) |
./vProxy_debug.sh -s -d vflrd -p program -l debug |
/opt/emc/vrproxy/runtime/logs/vflrd/vflrd-engine.logRegistros de sesiones de montaje de FLR individuales: /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>.logLos registros completados se transfieren a /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 |
Servidor REST: vrapid
| Demonio | Entidad de registro | Ejemplo de uso de comandos | Ubicación del registro |
|---|---|---|---|
vrapid |
Programa (motor principal) |
./vProxy_debug.sh -s -d vrapid -p program -l debug |
/opt/emc/vrproxy/runtime/logs/vrapid/vrapid-engine.log |
Los comandos anteriores muestran la habilitación de la depuración. Estos comandos se pueden volver a ejecutar para cambiar el -l Opción para restablecer los valores predeterminados:
Opciones:
- Para el registro del programa:
warn | info | trace (valor predeterminado) | debug
- Para el registro de DD Boost:
none | error | warn | info | debug | trace (valor predeterminado) | all
- Para el registro de VDDK:
0 = Sin registro
1 = Solo errores
2 = Advertencias y errores
3 = Mensajes de información importante, errores y advertencias (valor predeterminado)
4 = Datos de depuración más todo lo demás
- Para el registro del administrador de instantáneas:
warn | info | trace (valor predeterminado) | debug
Aplicación del método de depuración de servicio 2 (manualmente):
Para establecer el parámetro
vbackupd Proceso en la depuración a nivel de registro:
- Inicie sesión en el dispositivo vProxy como administrador a través de SSH o consola y cambie a root:
sudo su -
- Vaya a la página
systemdDirectorio:
cd /usr/lib/systemd/system/
vbackupd.service, vfrld.service, vrapid.service, vrecoverd.service, y otros criterios.
- Abra el archivo de servicio que requiere ajustes de depuración, por ejemplo:
vi vbackupd.service
- Localice la línea con
ExecStart=y agregue los parámetros de depuración deseados:
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
- Guarde los cambios en el archivo.
- Vuelva a cargar el archivo de configuración de la unidad escribiendo el comando:
systemctl daemon-reload
- Confirme en NetWorker Management Console que no haya respaldos en ejecución y, a continuación, reinicie el
vbackupddel servidor NMC:
systemctl restart vbackupd.service
El proceso anterior se aplica a los servicios vrapid, vrecoverd, vbackupd, vflrd.
Aplicación de la depuración de VDDK (manualmente):
La depuración del kit de desarrollo de discos (VDDK) de VMware se puede aplicar manualmente en VixDiskLib.config de NetWorker. Esta depuración solo se aplica a vbackupd y vrecoverd Solución de problemas. No se aplica a: vflrd.
- Inicie sesión en el dispositivo vProxy como administrador mediante SSH o la consola y cambie a root:
sudu su -
- Edite el archivo
VixDiskLib.configpara contener la siguiente línea:
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
- Reinicie el servicio correspondiente:
systemctl restart [service-name].service
systemctl restart vrecoverd.service
Una vez que se haya configurado el registro de depuración, el archivo de registro asociado con el servicio debe contener líneas DEBUG.
Después de completar el proceso de depuración, restablezca el nivel de registro mediante el mismo procedimiento, utilizando la palabra trace después del signo igual en lugar de debug. Para que este cambio se aplique de inmediato, es necesario volver a cargar y reiniciar el demonio, como se indicó anteriormente.
Depuración de certificados previos de DD Boost:
Este proceso se realiza con otros métodos de depuración descritos anteriormente. La biblioteca de DD Boost no registra actividad detallada de la interfaz de programación de aplicaciones (API) de manera predeterminada. La habilitación del registro de certificación previa de DD Boost solo se debe realizar cuando se observan otros errores relacionados con DD Boost en el vbackupd-boost.log, vrecovered-boost.log, vflrd-boost.log y se necesita depuración adicional. Por lo general, esto solo es necesario cuando lo solicita directamente el soporte de NetWorker para colaboraciones de Data Domain o participaciones de ingeniería.
- Inicie sesión en el dispositivo vProxy como administrador mediante SSH o la consola y cambie a root:
sudu su -
- Cree un archivo vacío llamado
ddboost_precert.inibajo/:
touch /ddboost_precert.ini
- Cree el archivo
DDLogDirectorio:
mkdir /DDLog
- Habilite la depuración de DD Boost para el servicio que requiere depuración:
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
- Confirme que el
ddboost_precert.logse genera, se reproduce el número y se recopila elddboost_precert.log:
ls -l /DDLog
- Cuando las operaciones de depuración ya no son necesarias:
- Vuelva a ejecutar el siguiente comando en el servicio para el que habilitó la depuración ddboost:
/opt/emc/vproxy/bin/vProxy_debug.sh -s -d service_name -p ddboost -l trace
-
- Elimine el archivo
/ddboost_precert.inide NetWorker.
- Elimine el archivo
rm -rf /ddboost_precert.ini
Registro de selección de vProxy:
Esta depuración se puede utilizar cada vez que un flujo de trabajo de respaldo de máquina virtual (VM) se bloquea con las VM en espera de ejecución. En este escenario, se inició el trabajo de respaldo, pero no se seleccionó ningún vProxy para iniciar la sesión de respaldo. No se registra el proceso de selección de vProxy en el registro estándar. Podemos habilitar vmbackup_logging en NetWorker Server, que registra el proceso de selección de vProxy durante el inicio de la política de protección de VMware. Esto es útil cuando no hay problemas de comunicación entre NetWorker Server y vProxy (puerto 9090) y no hay errores acerca de que el vProxy no está disponible en NMC o daemon.raw.
- Abra un símbolo del sistema administrativo de PowerShell (Windows) o una sesión de SSH raíz (Linux) en NetWorker Server.
- Cree un archivo sin una extensión llamado
vmbackup_loggingen NetWorker/nsr/tmpDirectorio:
Linux: touch /nsr/tmp/vmbackup_logging Windows: New-Item -Path "C:\Program Files\EMC NetWorker\nsr\tmp\vmbackup_logging" -ItemType File
/nsr/tmp en consecuencia.
- Inicie el trabajo de respaldo de VM.
- Monitoree el daemon.log representado para
Vmproxy Queueyselect_vproxymensajes.
Linux: /nsr/logs/daemon.log Windows: C:\Program Files\EMC NetWorker\nsr\logs\daemon.log
- Para desactivar esta depuración, elimine el archivo
vmbackup_loggingarchivo del archivo/nsr/tmpdir.
Información adicional
Artículos relacionados:
- Guía de triage de NVP-vProxy: Visión general de triage y registro de vProxy de NetWorker VMware Protection
- NVP vProxy: Cómo obtener la sintaxis exacta del comando para ejecutar una recuperación de VM desde la CLI con depuración.
- NetWorker (Linux): Cómo copiar archivos hacia y desde un servidor NetWorker Server de Linux.
- NVP vProxy: Solución de problemas de conectividad de red para operaciones de respaldo y restauración
- NetWorker: Solución de problemas de NVP vProxy para el rendimiento de respaldo y la restauración de VM