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

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

应用 vProxy Engine 调试的方法：

通常，分析 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
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 -

3. 更改为 vProxy 代理 bin 目录：

cd /opt/emc/vproxy/bin

4. 对于需要调试的服务，请运行以下命令：

备份引擎： 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

./vProxy_debug.sh -s -d vbackupd -p ddboost -l all

/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-boost.log

./vProxy_debug.sh -s -d vbackupd -p vddk -l 4

/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-vddk.log

./vProxy_debug.sh -s -d vbackupd -p snapshotmgr -l debug

/opt/emc/vrproxy/runtime/logs/vbackupd/vbackupd-snapmgr.log

恢复引擎： 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

./vProxy_debug.sh -s -d vrecoverd -p ddboost -l all

/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-boost.log

./vProxy_debug.sh -s -d vrecoverd -p vddk -l 4

/opt/emc/vrproxy/runtime/logs/vrecoverd/vrecoverd-vddk.log

FLR 引擎： vflrd

./vProxy_debug.sh -s -d vflrd -p program -l debug

/opt/emc/vrproxy/runtime/logs/vflrd/vflrd-engine.log

/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

./vProxy_debug.sh -s -d vflrd -p ddboost -l all

/opt/emc/vrproxy/runtime/logs/vflrd/vflrd-boost.log

REST 服务器： vrapid

./vProxy_debug.sh -s -d vrapid -p program -l debug

/opt/emc/vrproxy/runtime/logs/vrapid/vrapid-engine.log

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

选项：

• 对于程序日志：

• 对于 DD Boost 日志：

• 对于 VDDK 日志：

• 对于快照管理器日志：

应用服务调试方法 2（手动）：

1. 以管理员身份通过 SSH 或控制台登录 vProxy 一体机，然后切换到 root：

sudo su -

2. 转至 systemd 目录：

cd /usr/lib/systemd/system/ 

3. 打开需要调试设置的服务文件，例如：

vi vbackupd.service 

4. 使用以下命令找到该行 ExecStart= 并附加所需的调试参数：

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

5. 保存对该文件的更改。
6. 通过键入以下命令重新加载设备配置文件：

systemctl daemon-reload

7. 在 NetWorker Management Console 中确认没有正在运行的备份，然后重新启动 vbackupd 服务：

systemctl restart vbackupd.service

上述流程适用于服务 vrapid开始， vrecoverd开始， vbackupd开始， vflrd。

应用 VDDK 调试（手动）：

VMware 磁盘开发工具包 （VDDK） 调试可以在 VixDiskLib.config 文件中定义。此调试仅适用于 vbackupd 和 vrecoverd 故障诊断步骤进行操作。它不适用于 vflrd。
 

1. 以管理员身份使用 SSH 或控制台登录 vProxy 设备并切换到 root：

sudu su -

2. 编辑 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

3. 重新启动相关服务：

systemctl restart [service-name].service 

systemctl restart vrecoverd.service

设置调试日志记录后，与服务关联的日志文件应包含 DEBUG 行。

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

DD Boost Precert 调试：

此过程是使用上述其他调试方法完成的。默认情况下，DD Boost 库不会记录详细的应用程序编程接口 （API） 活动。仅当您在以下位置观察到其他与 DD Boost 相关的错误时，才应启用 DD Boost 预认证记录： vbackupd-boost.log开始， vrecovered-boost.log开始， vflrd-boost.log 需要文件和其他调试。通常只有在 NetWorker 支持人员直接请求 Data Domain 协作或工程合作时，才需要这样做。

1. 以管理员身份使用 SSH 或控制台登录 vProxy 设备并切换到 root：

sudu su -

2. 创建一个名为 ddboost_precert.ini Camera Control 下的 /管理此进程：

touch /ddboost_precert.ini

3. 创建 DDLog 目录：

mkdir /DDLog

4. 为需要调试的服务启用 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

5. 确认 ddboost_precert.log ，重现问题并收集 ddboost_precert.log管理此进程：

ls -l /DDLog

6. 当不再需要调试操作时：
   1. 针对启用了 ddboost 调试的服务重新运行以下命令：

/opt/emc/vproxy/bin/vProxy_debug.sh -s -d service_name -p ddboost -l trace

1. 2. 删除 /ddboost_precert.ini 文件中定义。

rm -rf /ddboost_precert.ini

vProxy 选择日志记录：

每当虚拟机 （VM） 备份工作流因虚拟机处于 “等待运行”状态而停滞时，都可以使用此调试。在这种情况下，备份作业已启动，但尚未选取任何 vProxy 来启动备份会话。标准日志记录中不会记录 vProxy 选择过程。我们可以启用 vmbackup_logging 在 NetWorker 服务器上，它会在 VMware 保护策略启动期间记录 vProxy 选择过程。当 NetWorker 服务器和 vProxy（端口 9090）之间没有通信问题，并且没有有关 vProxy 在 NMC 中不可用或 daemon.raw。

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

3. 启动虚拟机备份作业。
4. 监视呈现的daemon.log Vmproxy Queue 和 select_vproxy 消息。

Linux: /nsr/logs/daemon.log
Windows: C:\Program Files\EMC NetWorker\nsr\logs\daemon.log

5. 要禁用此调试，请删除 vmbackup_logging 文件，来自 /nsr/tmp 迪尔。

相关文章：

• NVP-vProxy 分流指南：NetWorker VMware Protection vProxy 分流和日志概述
• NVP vProxy：如何通过调试从 CLI 获取运行虚拟机恢复的确切命令语法。
• NetWorker (Linux)：如何将文件复制到 Linux NetWorker 服务器/从 Linux NetWorker 服务器拷贝文件。
• NVP vProxy：对备份和还原操作的网络连接进行故障处理
• NetWorker：NVP vProxy：虚拟机备份和还原性能和吞吐量故障处理