观看此视频:如何启用 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 和快照消息传送(如果适用)启用更多调试。
- 使用 vProxy 管理员 帐户通过 SSH 连接到 vProxy。
- 切换到 root:
sudo su -
- 更改为 vProxy 代理 bin 目录:
cd /opt/emc/vproxy/bin
- 对于要调试的服务,请运行以下命令:
备份引擎: 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
none
| error
| warn
| info
| debug
| trace
(默认) | all
0
= 无日志记录
1
= 仅错误
2
= 警告和错误
3
= 重要信息消息、错误和警告(默认值)
4
= 调试数据以及其他所有内容
warn
| info
| trace
(默认) | debug
应用服务调试方法 2:
可用的日志记录级别包括 none、error、warn、info、trace 和 debug。
要设置 vbackupd
进入日志记录级别 调试的过程:
- 以管理员身份通过 SSH 或控制台登录 vProxy 一体机,然后切换到 root:
sudo su -
- 转至
systemd
目录:
cd /usr/lib/systemd/system/
提醒:每个服务文件都可在此处找到: vbackupd.service, vfrld.service, vrapid.service, vrecoverd.service,
等等
- 打开要对其应用 debug 的服务文件,例如:
vi vbackupd.service
- 使用以下命令找到该行
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 一体>机属性 >配置 > 虚拟机代理版本。
- 保存对文件的更改
- 通过键入以下命令重新加载设备配置文件:
systemctl daemon-reload
- 在 NetWorker Management Console 中确认没有正在运行的备份,然后重新启动
vbackupd
服务:
systemctl restart vbackupd.service
上述流程适用于服务
vrapid, vrecoverd, vbackupd, vflrd.
应用 VDDK 调试:
- 以管理员身份使用 SSH 或控制台登录 vProxy 设备并切换到 root:
sudu su -
- 编辑 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
- 重新启动相关服务:
systemctl restart [service-name].service
例如:
systemctl restart vrecoverd.service
设置调试日志记录级别后,您可以确认相关日志文件中有以单词
Debug 开头的消息。
完成调试过程后,可以使用相同的过程重置日志级别,在等号后使用单词
trace 而不是
debug。为了立即应用此更改,需要重新加载和重新启动守护程序,如上所述。
DD Boost Precert 调试:
此过程是使用上述其他调试方法完成的。
- 以管理员身份使用 SSH 或控制台登录 vProxy 设备并切换到 root:
sudu su -
- 创建文件
ddboost_precert.ini
下:
/: touch /ddboost_precert.ini
- 创建
DDLog
目录:
mkdir /DDLog
- 为要调试的服务启用 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
- 确认
ddboost_precert.log
生成:
ls -l /DDLog
- 不再需要调试操作时,请重新运行以下命令:
vProxy_debug.sh -l trace
vProxy 选择日志记录:
每当虚拟机备份工作流因虚拟机处于
“等待运行”状态而卡住时,都可以使用此调试。在这种情况下,备份作业已启动,但尚未选取任何 vProxy 来启动备份会话。标准日志记录中不会记录 vProxy 选择过程。我们可以启用
vmbackup_logging
在 NetWorker 服务器上,它会在 VMware 保护策略启动期间记录 vProxy 选择过程。当 NetWorker 服务器和 vProxy(端口 9090)之间没有通信问题,并且在 NMC 或daemon.log中没有有关 vProxy 不可用的错误时,这可能很有用。
- 在 NetWorker 服务器上打开管理 PowerShell 提示符 (Windows) 或 root SSH 会话 (Linux)。
- 创建一个没有扩展名的文件,名为
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
因此。
- 启动虚拟机备份作业。
- 监视 Vmproxy 队列 呈现的daemon.log,然后选择 vproxy 消息。
Linux: /nsr/logs/daemon.log
Windows: C:\Program Files\EMC NetWorker\nsr\logs\daemon.log
- 要禁用此调试vmbackup_logging,请从
/nsr/tmp
迪尔。