Search <book_title>...

NetBackup™ 故障排除指南

Last Published: 2023-12-28

Product(s): NetBackup (10.3)

关于按作业 ID 收集日志

NetBackup 包括命令行界面和 API 选项，用于通过指定作业 ID 收集相关日志，然后上传收集的日志。使用指定的作业 ID 时，会从主服务器、介质服务器和客户端（如果可以访问）收集作业运行时间范围内的日志。

旧有日志和 try 文件日志可能包括作业运行时间范围之外的日志，因为这些日志不支持持续时间过滤器。可以收集某个作业层次结构中涉及的所有主机上的日志，方法是通过指定具有该层次结构的作业 ID。Veritas 建议使用时间同步来收集作业持续时间内包含的所有主机上的日志。活动监视器中必须存在有效作业 ID。默认情况下，作业 ID 会在作业完成一周后删除。如果 bpdbjobs 或活动监视器无法检索指定作业 ID 的作业详细信息，则 nblogadm 实用程序无法收集作业 ID 的日志。此外，日志收集命令行界面和 API 选项不支持“立即备份”作业。不会从二线支持介质服务器或客户端收集 VxUL 日志。

收集的日志包括 NetBackup 产品和 NetBackup 支持实用程序 (nbsu) 日志。日志收集支持一次一个记录 ID，不会从多个记录 ID 并行收集日志。

要避免在日志收集期间填满主服务器、介质服务器和客户端上的文件系统，Veritas 建议使用 KEEP_LOGS_SIZE_GB 选项。Veritas 建议在收集日志之前指定保留的 NetBackup 日志大小。有关更多信息，请参见《NetBackup 管理指南，第 I 卷》。

NetBackup 10.2 中引入了基于时间的日志清理过程。收集日志 7 天后，如果未删除日志，此过程将删除收集的日志和日志记录。要在主服务器或介质服务器上将日志保留期限缩短至 5 天，请使用 bpsetconfig 将 LOG_RECORD_EXPIRY_DAYS 设置为 5。要在客户端上将日志保留期限缩短至 5 天，请使用 nbsetconfig 将 LOG_RECORD_EXPIRY_DAYS 设置为 5。较小的数字优先。如果在日志清理过程中遇到错误，NetBackup 可能不会从二线支持介质服务器或客户端删除日志。遇到这种情况时，Veritas 建议手动删除遗留的日志。

为避免收集的日志填满主服务器上的文件系统，会使用预定义的 10 GB 可用空间标记。当可用磁盘空间低于标记大小与所收集日志估计大小之和时，NetBackup 可使用此标记进行检查并防止启动日志收集。此外，当主服务器上的可用空间低于标记大小与所收集日志估计大小之和时，日志收集过程将停止。在此版本中，可用空间检查将扩展到介质服务器和客户端。要将可用空间标记减少至 5 GB，请使用 bpsetconfig 命令设置 HIGH_WATERMARK_TRB_LOG_RECORDS = 5。

有两个选项可以收集更详细的日志。可以手动启用日志记录并配置所需的日志记录级别，如《NetBackup 日志记录参考指南》中所述。或者，也可以使用命令行界面和 API 选项，在主服务器、介质服务器或客户端上收集日志和配置日志记录级别值。然后，重新启动作业并启动日志收集任务。该功能包括一个 API 选项，用于在重新启动最初指定的作业后检索新作业的作业 ID。

收集更详细的日志需要两个日志记录 ID。第一个日志记录 ID（记录 ID 1），用于启用日志记录并为具有作业 ID（作业 ID 1）的主机配置所需的日志记录级别。配置日志记录级别并重新启动原始作业（作业 ID 1）后，将生成新的作业 ID（作业 ID 2）。第二个日志记录 ID（记录 ID 2），用于在新的重新启动作业（作业 ID 2）运行时间范围内从主服务器、介质服务器和客户端（如果可访问）收集日志。在包含多个介质服务器和客户端的备份域中，具有记录 ID 1 和记录 ID 2 的介质服务器或客户端可能由于不同的作业计划算法而不同。

在 NetBackup 10.2 及更高版本中，所示目录的 Progress.txt 文件中包含每个已收集日志的 SHA256 校验和。校验和无法在安装了 NetBackup 的二线支持介质服务器或客户端上进行计算。

Progress.txt 文件的位置：

Linux 和 UNIX
/usr/openv/netbackup/logs/nblastaging/record ID-timestamp: YYYYMMDD-HHMMSS
Windows
install_path\Veritas\NetBackup\logs\nblastaging\record ID-timestamp: YYYYMMDD-HHMMSS

NetBackup 10.2 及更高版本包括对主服务器上所需日志存储空间的空间使用增强功能。从主服务器、介质服务器和客户端收集的日志文件不再存储在主服务器上。这些文件驻留在每个主机的所示目录中。

Linux 和 UNIX
/usr/openv/netbackup/logs/nblaevidence/nbla-hash
Windows
install_path\Veritas\NetBackup\logs\nblaevidence\nbla-hash

支持的作业类型：

备份
从快照备份
快照

支持的工作负载类型：

文件系统
Hadoop（仅从主服务器和介质服务器收集日志）
Microsoft Exchange（仅从主服务器和介质服务器收集日志）
Windows Server 故障转移群集 (WSFC)
Microsoft SQL Server 可用性组
NDMP（仅从主服务器和介质服务器收集日志）
Oracle
Snapshot Manager（仅从主服务器和介质服务器收集日志）
VMware

如果在主服务器上设置 disableIPResolution 选项，则指定 VMware 工作负载类型的作业 ID 时，不会收集受保护虚拟机上的日志。有关设置的更多详细信息，请参见 https://www.veritas.com/content/support/en_US/doc/21902280-158271263-0/v38310204-158271263。

此版本支持从包含多个客户端的分布式工作负载收集日志。分布式工作负载示例包括 Oracle RAC 和 MSSQL 可用性组。

可以使用命令行界面和 API 选项以及有效的支持案例 ID 将收集的日志上传到 Veritas 技术支持组织。有关更多详细信息，请参见 https://www.veritas.com/support/en_US/article.100038665。

为上传日志而提供给 API 的密码以凭据对象的形式存储在“NetBackup 凭据管理”窗格中。在上传日志后，会将其删除。

由收集的日志组成的单个 tar 文件将上传到 Veritas 技术支持组织的 SFTP 服务器或指定的 SFTP 服务器。如果 Veritas 技术支持组织不管理 SFTP 服务器，当 SFTP 服务器上存在同名 tar 文件时，上传操作将失败。

按作业 ID 收集日志时，使用 nblogadm 日志进行调试或故障排除。将 nblogadm 日志用于命令行界面和 API 选项。要从 nblogadm 进程收集日志，请确认显示的目录存在：

Linux 和 UNIX
/usr/openv/netbackup/logs/nblogadm
Windows
install_path\Veritas\NetBackup\logs\nblogadm

表：nblogadm 实用程序引入了新的命令行界面标志

命令行界面	描述
nblogadm --action getactivecollections --json	获取进行中的记录数。（不会一次收集多个记录 ID 的日志）
*nblogadm --action createrecord --jobid job ID* --json**	获取作业 ID、创建空日志记录并返回创建的记录 ID。
*nblogadm --action collectlogsforjob --recid record ID* --runnbsu --json**	创建任务以收集指定记录 ID 的日志。
nblogadm --action startupload --recid record ID --sftp_host sftp host --sftp_port sftp port --supportcase support case ID --target_folder sftp host folder --fingerprint sftp host fingerprint, use comma as delimiter without spaces --passcredentials --json	创建任务以上传指定记录 ID 的日志和 SFTP 服务器访问信息。
*nblogadm --action deleterecord --recid record ID* --json**	删除收集的指定记录 ID 的日志和记录。此操作还会终止任何正在进行的任务。
*nblogadm --action casedetail --recid record ID* --json**	获取指定记录 ID 的日志收集和日志上传任务详细信息。
*nblogadm --action getlogging --recid record ID* --json**	对于指定的记录 ID，获取主机、其组件以及相应日志记录级别值的列表。
*nblogadm --action getlogging --recid record ID* [--hostandlog MASTER\|MEDIA\|CLIENT:hostname] --json**	指定 --hostandlog 参数时，对于指定的记录 ID，此命令将返回指定主机的组件日志记录级别值。如果不指定 --hostandlog 参数，对于指定的记录 ID，该命令将返回一系列主机的组件日志记录级别值。
nblogadm --action setlogging --recid record ID --hostandlog MASTER\|MEDIA\|CLIENT:hostname@legacy component1=legacy component1 level,vxul component1=debug level%diagnostic level,misc type=misc type value --json	对于指定的记录 ID，更新指定主机的组件日志记录级别设置。需要单独调用才能更新每个主机。指定的旧版和 vxul 组件名称必须为小写。