NetWorker VMware Protection-vProxy:如何啟用除錯紀錄
Summary: 若要針對 NetWorker VMware Protection (NVP) 與 vProxy 裝置解決方案 (NVP-vProxy) 故障診斷問題,可能需要將記錄層級變更為「debug」。本文說明如何變更紀錄層級。
Instructions
觀看本影片:如何啟用 vProxy 除錯記錄。
套用 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 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.logVDDK 還會在目錄中維護私有日誌 /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.logVDDK 還會在目錄中維護私有日誌 /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 |
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 (手動):
為了設定
vbackupd 進入記錄層 級除錯的程序:
- 以系統管理員身分透過 SSH 或主控台登入 vProxy 應用裝置,然後切換至 root:
sudo su -
- 前往
systemd目錄:
cd /usr/lib/systemd/system/
vbackupd.service, vfrld.service, vrapid.service, vrecoverd.service, 等
- 開啟需要除錯設定的服務檔案,例如:
vi vbackupd.service
- 使用以下方式找到該行
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
- 儲存對檔案所做的變更。
- 輸入以下命令以重新載入裝置設定檔:
systemctl daemon-reload
- 在 NetWorker Management Console 中確認沒有執行中的備份,然後重新開機。
vbackupd服務:
systemctl restart vbackupd.service
上述程序適用於服務 vrapid小 vrecoverd小 vbackupd小 vflrd。
套用 VDDK 除錯 (手動):
VMware 磁碟開發套件 (VDDK) 偵錯可手動套用至 VixDiskLib.config 檔案中所定義。此除錯僅適用於 vbackupd 和 vrecoverd 故障診斷。它不適用於 vflrd。
- 使用 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 行。
完成調試過程后,使用相同的過程重置日誌級別,使用等號后的單詞 跟蹤而不是 調試。為了立即應用此更改,需要如上所述重新載入並重新啟動守護程式。
DD Boost Precert 除錯:
此過程使用上述其他調試方法完成。根據預設,DD Boost 程式庫不會記錄詳細的應用程式發展介面 (API) 活動。只有在您發現其他 DD Boost 相關錯誤存在於 vbackupd-boost.log小 vrecovered-boost.log小 vflrd-boost.log 需要檔和其他調試。通常只有在 NetWorker 支援部門直接要求 Data Domain 協同合作或專案參與時,才需要使用此功能。
- 使用 SSH 或主控台,以系統管理員身分登入 vProxy 裝置,然後切換至 root:
sudu su -
- 建立名為
ddboost_precert.ini功能 (在 DPM 應用程式中的/:
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的設定,重現問題並收集ddboost_precert.log:
ls -l /DDLog
- 不再需要除錯作業時:
- 針對您啟用 ddboost 除錯的服務,重新執行下列命令:
/opt/emc/vproxy/bin/vProxy_debug.sh -s -d service_name -p ddboost -l trace
-
- 刪除
/ddboost_precert.ini檔案中所定義。
- 刪除
rm -rf /ddboost_precert.ini
vProxy 選取記錄:
只要虛擬機器 (VM) 備份工作流卡住,虛擬機處於 等待運行狀態,就可以使用此調試。在這種情況下,備份工作已啟動,但尚未選取 vProxy 來啟動備份工作階段。標準紀錄中不會記錄 vProxy 選取程序。我們可以使 vmbackup_logging ,它會在 VMware 保護原則啟動期間記錄 vProxy 選擇程序。如果 NetWorker 伺服器和 vProxy (連接埠 9090) 之間沒有通訊問題,而且在 NMC 或 NMC 中沒有任何關於 vProxy 無法使用的錯誤,這就會很實用。 daemon.raw。
- 在 NetWorker 伺服器上開啟系統管理 PowerShell 提示 (Windows) 或根 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
/nsr/tmp 因此。
- 啟動 VM 備份工作。
- 監視呈現的daemon.log
Vmproxy Queue和select_vproxy消息。
Linux: /nsr/logs/daemon.log Windows: C:\Program Files\EMC NetWorker\nsr\logs\daemon.log
- 若要關閉此除錯,請刪除
vmbackup_logging檔案來源/nsr/tmp目錄。
Additional Information
相關的文章: