NetWorker VMware Protection-vProxy: Cómo habilitar el registro de depuración
Summary: Es posible que sea necesario cambiar el nivel de registro al nivel “debug” para solucionar un problema con NetWorker VMware Protection con la solución del dispositivo vProxy (NVP-vProxy). En este artículo, se explica cómo cambiar el nivel de registro. ...
Instructions
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. Esto normalmente solo es necesario una vez que se solicitó soporte de NetWorker y el ingeniero de soporte ha solicitado configurar una 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/logsHay un subdirectorio para cada uno de los procesos principales que se utilizan en las operaciones de NetWorker en el dispositivo vProxy:
vbackupd vflrd vrapid vrecoverd
Por ejemplo, el método vbackupd 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 posterior de vProxy.1. 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 a vProxy mediante SSH usando la cuenta de administrador de vProxy.2.
- 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:
Backup Engine vbackupd
| Demonio | Entidad de registro | Ejemplo de uso del comando | Ubicación del registro |
|---|---|---|---|
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
|
|
| Administración 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 del comando | Ubicación del registro |
|---|---|---|---|
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
|
FLR Engine: vflrd
| Demonio | Entidad de registro | Ejemplo de uso del comando | Ubicación del log |
|---|---|---|---|
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 del comando | Ubicación del log |
|---|---|---|---|
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
- Deshabilite el registro de DD Boost.
none | error | warn | info | debug | trace (valor predeterminado) all
- Para el registro de VDDK:
0 0: sin registros
1 = Solo errores
2 Avisos y errores
3 3: Mensajes de información importantes, errores y advertencias
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:
Para establecer el parámetro
vbackupd Proceso en la depuración a nivel de registro:
- Inicie sesión en el dispositivo vProxy como administrador mediante ssh o consola y cambie a root:
sudo su -
- Vaya a:
systemddirectorio:
cd /usr/lib/systemd/system/
vbackupd.service, vfrld.service, vrapid.service, vrecoverd.service, y así sucesivamente
- 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 unidad escribiendo el siguiente comando:
systemctl daemon-reload
- Confirme en NetWorker Management Console que no haya respaldos en ejecución y, luego, reinicie el servicio vbackupd:
vbackupdServices
systemctl restart vbackupd.service
systemctl restart vbackupd.serviceEl proceso anterior se aplica a los servicios: vrapid, vrecoverd, vbackupd, vflrd.
Aplicación de depuración de VDDK:
La depuración del kit de desarrollo de discos (VDDK) de VMware se puede aplicar manualmente en VixDiskLib.config file. Esta depuración solo se aplica a vbackupd y vrecoverd con la solución de problemas. No se aplica para vflrd.
- Inicie sesión en el dispositivo vProxy como administrador mediante SSH o la consola y cambie a root:
sudu su -
- Editar 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 esto se aplique de inmediato, necesitará volver a cargar y reiniciar el demonio, como se indicó anteriormente.
Depuración de certificados previos de DD Boost:
Este proceso se puede realizar en combinación con otros métodos de depuración descritos anteriormente.1. 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 el
ddboost_precert.inibajo/:
vi /ddboost_precert.ini
Agregue la siguiente información en el archivo:
precert_enabled=true
num_log_files=4
log_file_size=512
log_file_name=ddboost_precert.log
log_file_dir=/DDLog
ddcl_logs_include=true
ddcl_logs_sev=3
- Cree el
DDLogdirectorio:
mkdir /DDLog ; chmod 755 /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
- Uso
precert-io-perf.pyPara analizar elddboost_precert.logfiles: NetWorker: Cómo analizar el rendimiento de I/O mediante ddboost_precert.log - 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.inifile.
- 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 habilitarlo. 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_vproxymensaje:
Linux: /nsr/logs/daemon.log Windows: C:\Program Files\EMC NetWorker\nsr\logs\daemon.log
- Para deshabilitar esta función, elimine el dominio.
vmbackup_loggingarchivo del archivo/nsr/tmpdir.
Depuración de la interfaz de usuario de vProxy:
Additional Information
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 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 respaldo y restauración de VM en NVP vProxy rendimiento