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

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

应用 vProxy Engine 调试的方法：

通常，在 中分析 NetWorker 服务器的策略日志就足够了 /nsr/logs/policy/[policy name]，但有时可能需要分析来自 vProxy 设备本身的日志，进而提高 调试的日志记录级别，以便更清楚地了解失败原因。通常，只有在 NetWorker 支持参与并且支持工程师请求设置为 debug 以进行故障处理后，才需要这样做。

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 及更高版本。1.它可用于在 vProxy 服务上启用 调试 （vrapid, vrecoverd, vbackupd, vflrd)。可以为 DD Boost 流量、虚拟磁盘开发工具包 （VDDK） 和快照消息传送（如果适用）启用更多调试。

1. 使用 vProxy 管理员帐户通过 SSH 连接到 vProxy。2.
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 日志：

• 对于 Snapshot Manager 日志：

应用服务调试方法 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.
6. 通过键入以下命令重新加载设备配置文件：

systemctl daemon-reload

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

systemctl restart vbackupd.service

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

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

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

DD Boost 预认证调试：

此过程可与上述其他调试方法一起使用。1.默认情况下，DD Boost 库不会记录详细的应用程序编程接口 （API） 活动。仅当您在 DD Boost 中观察到其他与 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 下的 /中的用户名和密码： 

vi /ddboost_precert.ini

在文件中添加以下内容：

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

3. 创建 DDLog 日志文件：

mkdir /DDLog ; chmod 755 /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. 使用 precert-io-perf.py 要分析 ddboost_precert.log 文件： NetWorker：如何使用 ddboost_precert.log 分析 IO 性能
7. 不再需要调试操作时：
   1. 对已启用 ddboost debug 的服务重新运行以下命令：

/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）之间没有通信问题，并且没有关于 NMC 中 vProxy 不可用的错误或 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. 监视呈现的守护程序.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 导演。

vProxy 用户界面调试：

• NVP-vProxy：Data Protection Restore Client （DPRC） 故障处理指南
• NVP-vProxy：vCenter 插件程序和用户界面 （VCUI） 故障处理

相关文章：

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