Skip to main content
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products

NetWorker VMware Protection-vProxy:如何启用调试日志记录

Summary: 可能需要将日志级别更改为“debug”,以便对 NetWorker VMware Protection (NVP) 和 vProxy 一体机解决方案 (NVP-vProxy) 的问题进行故障处理。本文介绍如何更改日志级别。

This article applies to   This article does not apply to 

Instructions

观看此视频:如何启用 vProxy 调试日志记录。

 


通常,分析 NetWorker 服务器的策略日志就足够了 /nsr/logs/policy/[policy name],但有时可能需要分析来自 vProxy 设备本身的日志,此外,还需要提高调试的日志记录 级别,以便更清楚地了解故障原因。这通常仅在 NetWorker 支持人员参与并且支持工程师请求调试设置为故障处理作为特定过程后才需要。

vProxy 设备上的 NVP-vProxy 日志文件位于以下目录中 /opt/emc/vproxy/runtime/logs

用于 vProxy 一体机上的 NetWorker 操作的每个主体进程都有一个子目录:
vbackupd

vflrd

vrapid

vrecoverd
例如,在 vbackupd 子目录中,您有日志:
[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
有关 vProxy 日志记录和收集的其他信息,请参阅文章 NVP-vProxy 分流指南:NetWorker VMware Protection vProxy 分流和日志概述


应用服务调试方法 1:

此方法适用于 vProxy 的 4.3.x 及更高版本。它可用于在 vProxy 服务上启用 调试 vrapid, vrecoverd, vbackupd, vflrd)时,此方法起作用。可以为 DD Boost 流量、VDDK 和快照消息传送(如果适用)启用更多调试。
  1. 使用 vProxy 管理员 帐户通过 SSH 连接到 vProxy。
  2. 切换到 root:
sudo su -
  1. 更改为 vProxy 代理 bin 目录:
cd /opt/emc/vproxy/bin
  1. 对于要调试的服务,请运行以下命令:

备份引擎: vbackupd
守护 进程 日志记录实体 命令用法示例 日志位置
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
  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
VDDK 还在目录中维护私有日志 /tmp/vmware-root
       快照管理器
./vProxy_debug.sh -s -d vbackupd -p snapshotmgr -l debug
/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-snapmgr.log

恢复引擎: vrecoverd
守护 进程 日志记录实体 命令用法示例 日志位置
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
  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
VDDK 还在目录中维护私有日志 /tmp/vmware-root

FLR 引擎: vflrd
守护 进程 日志记录实体 命令用法示例 日志位置
vflrd 程序(主机)
./vProxy_debug.sh -s -d vflrd -p program -l debug
/opt/emc/vrproxy/runtime/logs/vflrd/vflrd-engine.log
单个 FLR 装载会话日志:
/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
  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
VDDK 还在目录中维护私有日志 /tmp/vmware-root

REST 服务器: vrapid
守护 进程 日志记录实体 命令用法示例 日志位置
vrapid 程序(主机)
./vProxy_debug.sh -s -d vrapid -p program -l debug
/opt/emc/vrproxy/runtime/logs/vrapid/vrapid-engine.log

上面的命令显示如何启用调试,可以重新运行这些命令,更改 -l 重置为默认值的选项:

选项:
  • 对于程序日志:
warn | info | trace (默认) | debug
  • 对于 DD Boost 日志:
none | error | warn | info | debug | trace (默认) | all
  • 对于 VDDK 日志:
0 = 无日志记录
1 = 仅错误
2 = 警告和错误
3 = 重要信息消息、错误和警告(默认值)
4 = 调试数据以及其他所有内容
  • 对于快照管理器日志:
warn | info | trace (默认) | debug


应用服务调试方法 2:

可用的日志记录级别包括 none、error、warn、info、trace 和 debug。

要设置 vbackupd 进入日志记录级别 调试的过程:
  1. 以管理员身份通过 SSH 或控制台登录 vProxy 一体机,然后切换到 root:
sudo su -
  1. 转至 systemd 目录:
cd /usr/lib/systemd/system/ 

提醒:每个服务文件都可在此处找到: vbackupd.service, vfrld.service, vrapid.service, vrecoverd.service, 等等
  1. 打开要对其应用 debug 的服务文件,例如:
vi vbackupd.service 
  1. 使用以下命令找到该行 ExecStart= 并附加 --program-log-level=debug
其他参数:
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
 
提醒:NVP-vProxy 版本显示在 NetWorker Management Console >设备 > VMware 代理>中 vProxy 属性的配置选项卡中,右键单击 vProxy 一体>机属性 >配置 > 虚拟机代理版本。  
 
  1. 保存对文件的更改
  2. 通过键入以下命令重新加载设备配置文件:
systemctl daemon-reload
  1. 在 NetWorker Management Console 中确认没有正在运行的备份,然后重新启动 vbackupd 服务:
systemctl restart vbackupd.service
上述流程适用于服务 vrapid, vrecoverd, vbackupd, vflrd.


应用 VDDK 调试:

  1. 以管理员身份使用 SSH 或控制台登录 vProxy 设备并切换到 root:
sudu su -
  1. 编辑 VixDiskLib.config 文件以包含以下行:
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. 重新启动相关服务:
systemctl restart [service-name].service 
例如: 
systemctl restart vrecoverd.service
设置调试日志记录级别后,您可以确认相关日志文件中有以单词 Debug 开头的消息。

完成调试过程后,可以使用相同的过程重置日志级别,在等号后使用单词 trace 而不是 debug。为了立即应用此更改,需要重新加载和重新启动守护程序,如上所述。


DD Boost Precert 调试:

此过程是使用上述其他调试方法完成的。
  1. 以管理员身份使用 SSH 或控制台登录 vProxy 设备并切换到 root:
sudu su -
  1. 创建文件 ddboost_precert.ini 下:
/: touch /ddboost_precert.ini
  1. 创建 DDLog 目录:
mkdir /DDLog
  1. 为要调试的服务启用 DD Boost 调试:
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. 确认 ddboost_precert.log 生成:
ls -l /DDLog
​​​​​​ 日志确认屏幕截图
  1. 不再需要调试操作时,请重新运行以下命令:
vProxy_debug.sh -l trace


vProxy 选择日志记录:

每当虚拟机备份工作流因虚拟机处于 “等待运行”状态而卡住时,都可以使用此调试。在这种情况下,备份作业已启动,但尚未选取任何 vProxy 来启动备份会话。标准日志记录中不会记录 vProxy 选择过程。我们可以启用 vmbackup_logging 在 NetWorker 服务器上,它会在 VMware 保护策略启动期间记录 vProxy 选择过程。当 NetWorker 服务器和 vProxy(端口 9090)之间没有通信问题,并且在 NMC 或daemon.log中没有有关 vProxy 不可用的错误时,这可能很有用。
 
  1. 在 NetWorker 服务器上打开管理 PowerShell 提示符 (Windows) 或 root SSH 会话 (Linux)。
  2. 创建一个没有扩展名的文件,名为 vmbackup_logging 在 NetWorker 下 /nsr/tmp 目录:
Linux: 
touch /nsr/tmp/vmbackup_logging

Windows: 
New-Item -Path "C:\Program Files\EMC NetWorker\nsr\tmp\vmbackup_logging" -ItemType File
以上命令假定使用了默认的 NetWorker 安装位置。如果 NetWorker 安装在不同的位置下,请调整 /nsr/tmp 因此。
  1. 启动虚拟机备份作业。
  2. 监视 Vmproxy 队列 呈现的daemon.log,然后选择 vproxy 消息。
Linux: /nsr/logs/daemon.log
Windows: C:\Program Files\EMC NetWorker\nsr\logs\daemon.log
如有任何疑问,请参阅文章:NetWorker:如何使用 nsr_render_log。
  1. 要禁用此调试vmbackup_logging,请从 /nsr/tmp 迪尔。

Additional Information

Affected Products

NetWorker

Products

NetWorker, NetWorker Series