Search <book_title>...

NetBackup™ 故障排除指南

Last Published: 2023-01-17

Product(s): NetBackup & Alta Data Protection (10.1.1)

关于按作业 ID 收集日志

NetBackup 中包含新的命令行界面和 API 选项，用于通过指定作业 ID 收集相关日志，然后上传收集的日志。使用指定的作业 ID 时，会从主服务器、介质服务器和客户端（如果可以访问）收集作业执行时间范围内的日志。旧有日志和 try 文件日志可能包括作业执行时间范围之外的日志，因为这些日志不支持持续时间过滤器。

活动监视器中必须存在有效作业 ID。默认情况下，作业 ID 会在作业完成一周后删除。如果 bpdbjobs 或活动监视器无法检索指定作业 ID 的作业详细信息，则 nblogadm 实用程序无法收集作业 ID 的日志。

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

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

为避免收集的日志填满主服务器上的文件系统，会使用预定义的 10 GB 可用空间标记。NetBackup 可使用此标记进行检查并防止在可用磁盘空间低于标记时开始收集日志。此外，在日志收集期间，当主服务器上的可用空间低于标记时，收集过程会停止。要将可用空间标记减少至 5 GB，请在 bp.conf 文件中设置 HIGH_WATERMARK_TRB_LOG_RECORDS = 5。

要收集更详细的日志，请手动启用日志记录并配置所需的日志记录级别，如《NetBackup 日志记录参考指南》中所述。然后，重新启动作业并启动日志收集任务。

收集的日志存储在主服务器上的所示目录中。启动日志上传任务后，将上传该目录中的所有内容。确认目录中仅存在所需文件：

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

支持的作业类型：

备份
从快照备份
快照

支持的工作负载类型：

文件系统
NDMP（仅从主服务器和介质服务器收集日志）
Oracle（仅从主服务器收集日志）
Snapshot Manager（仅从主服务器和介质服务器收集日志）
VMware

不支持的配置：

Microsoft 群集服务器 (MSCS)
VMware 访问主机

可以从涉及多个客户端的分布式工作负载收集日志。必须在活动监视器中手动收集每个作业的日志，其中特定的客户端或节点显示在“客户端”列中。然后，必须合并所有日志。分布式工作负载示例包括 Oracle RAC 和 MSSQL 可用性组。

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

为上传日志而提供的密码以凭据对象的形式存储在“NetBackup 凭据管理”窗格中。在上传日志后，会将其删除。在上传期间，凭据对象的名称可能会短暂显示，但不会显示密码本身。

表：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 deleterecord --recid record ID* --json**	删除收集的指定记录 ID 的日志和记录。此操作还会终止任何正在进行的任务。
*nblogadm --action casedetail --recid record ID* --json**	获取指定记录 ID 的日志收集和日志上传任务详细信息。

表：新的 NetBackup API

API	描述
GET /troubleshooting/log-records	获取进行中的记录数。（不会一次收集多个记录 ID 的日志）
POST /troubleshooting/log-records	获取作业 ID、创建空日志记录并返回创建的记录 ID。
*POST /troubleshooting/log-records/record ID/collect*	创建任务以收集指定记录 ID 的日志。
*POST /troubleshooting/log-records/record ID/upload*	创建任务以上传指定记录 ID 的日志和 SFTP 服务器访问信息。
DELETE /troubleshooting/log-records/record ID	删除收集的指定记录 ID 的日志和记录。此操作还会终止任何正在进行的任务。
GET /troubleshooting/log-records/record ID	获取指定记录 ID 的日志收集和日志上传任务详细信息。