AutoSupport 清单在 ONTAP 9 中将文件集合报告为截断或跳过
适用于
- ONTAP 9
- AutoSupport
问题描述
- 在某些情况下,AutoSupport 数据在收集或传输(交付)过程中可能会被截断。
- 如果内容过大,无法满足特定 AutoSupport 子系统的大小预算限制,或在传输过程中超出整体 AutoSupport 负载大小,则可能会发生截断。
- 如果在 AutoSupport 消息中发现某些内容缺失,截断可能会影响主动和被动支持能力;但只要日志仍然保留在系统中,可以通过 SPI 手动提取日志。
发生原因
- 针对 AutoSupport 子系统的数据收集已超出您所用 ONTAP 版本设定的时间或大小限制
- ONTAP 内的每个子系统都为整体 AutoSupport 内容的收集做出贡献
- 为了确保 AutoSupport 的数据收集达到最佳和高效,每个子系统都有收集大小和时间预算,以防止任何一个子系统在某个日志或文件上花费过多时间。
- 整体 AutoSupport 消息传递大小已超过所用传输方式(SMTP 或 HTTPS)的最大限制
- 默认的 SMTP 传送大小预算为 5 MB
- 默认的 HTTPS 传送大小预算为 50 MB
解决方案
如何确定哪些 AutoSupport 数据被截断
- 运行 system node autosupport manifest show 命令,以获取由于截断而受影响的完整文件列表:
::>autosupport manifest show -node * -status *-limit AutoSupport Collected
Node Sequence Body Filename Size Status Error
--------- -------- -------------- ----------- --------- -----------
node-01 14
rdb_dump.txt 1KB collection-truncated-file-size-limit This log file's contents are truncated.
cluster_ha.xml 730KB collection-truncated-file-size-limit This log file's contents are truncated.
- 要查看特定的 AutoSupport 消息,请指定该消息的序列号:
::>autosupport manifest show -seq-num 14 -fields prio-num,body-file,subsys,status,error,size-collected -subsys mhost -node local
node seq-num prio-num subsys body-file size-collected status error
------- ------- -------- ------ ------------ -------------- ------------------------------- -----
node-01 14 39 mhost rdb_dump.txt 1KB collection-truncated-size-limit ""
node-01 14 40 mhost cluster_ha.xml 730B collection-truncated-size-limit ""
AutoSupport 消息的清单信息将包含以下错误收集代码之一:
collection-truncated-size-limitcollection-skipped-size-limitcollection-truncated-time-limitcollection-skipped-time-limitdelivery-skipped-size-limit
预期行为
- 某些文件(例如日志文件)在 AutoSupport 收集中有单独的大小限制。
- 查看 追加信息部分 ,详细了解哪些日志已知超出限制。
- 如果由于文件特定限制而导致文件集合被截断,则此情况下的清单状态为
collection-truncated-file-size-limit。- 这种截断是预料之中的,可以忽略。
- 特定文件的预算是硬编码的,无法配置。
- 这种截断是预料之中的,可以忽略。
"delivery-skipped-size-limit" 错误
AutoSupport 传输协议为 SMTP
- 将 AutoSupport 传输方式更改为 HTTPS(NetApp 推荐)
- 如果当前将 AutoSupport 配置为使用 SMTP 作为传输方式,请修改 -transport 参数(联系支持的协议),将其从 SMTP 更改为 HTTPS。
- 使用 HTTPS 传输协议时,整体 AutoSupport 消息大小可以更大(默认:50 MB),并且与 NetApp 的连接是加密且安全的。
- 请确保 node-mgmt 和 cluster-mgmt LIF 的出站通信能够连接到目标的 TCP 端口 443: support.netapp.com/cn。
- 如果您为环境配置了 HTTP 代理,请确认代理可以访问。
- 如果当前将 AutoSupport 配置为使用 SMTP 作为传输方式,请修改 -transport 参数(联系支持的协议),将其从 SMTP 更改为 HTTPS。
- 如果无法将 AutoSupport 传输更改为 HTTPS,请将 SMTP 最大大小增加到您的 SMTP 服务器支持的限制
AutoSupport 传输协议为 HTTPS
- 发送到 support.netapp.com 通常会成功,但内部/合作伙伴 AutoSupport 消息可能会被截断
- 注意:AutoSupport 消息通过电子邮件(SMTP)发送,适用于任何已配置的 -to 或 -partner-address 电子邮件目标地址。
- 请参见: AutoSupport Notifyd 日志 - 添加 <file> 时出错:需要增加有效负载大小
"collection-truncated-* " 和 "collection-skipped-* " 错误
- 请记录受影响的 AutoSupport 子系统和数据文件
- 如果您持续看到子系统内容被截断,请联系 NetApp 支持:
追加信息
- 如何管理 ONTAP 9 AutoSupport 子系统大小和时间预算
- 如何在 ONTAP 9 中设置或修改 AutoSupport
- 要了解有关 AutoSupport 的更多信息,请参见 TR-4444 - ONTAP AutoSupport 和 AutoSuport 按需配置指南。
注:
- 如果子系统大小限制被突破,并非所有文件都会被截断。
- 超过子系统限制的二进制文件(7z、tgz、tar)不会被截断——它们会被完全跳过,不包含在 AutoSupport 消息中。
- 只有 ASCII 文件(文本、XML)会被截断。
特定 AutoSupport 子系统注意事项
splog_latest
- 以下文件可能由于文件特定的大小限制而被截断,错误:
collection-truncated-file-size-limit:sp-latest-system-event-log.txtsp-latest-syslog.txtsp-latest-statistics.txtsp-downcontroller-syslog.txtsp-downcontroller-statistics.txt
- 以下文件可能由于文件特定的大小限制而被截断,错误:
- 示例:内容
sp-latest-system-event-log.txt在 ONTAP 中被设置为最大 71,680 字节。
log_files
- 以下文件通常由于特定文件预算而被截断,即
collection-truncated-file-size-limit
- 以下文件通常由于特定文件预算而被截断,即
注意:这不是详尽列表:
command-history.gzmgwd.gzsecd.gzsktrace.gz
- 这些日志会不断更新和轮换。
- 这些日志会在每日管理日志 AutoSupport 消息中收集
- 此行为是预期的。
- 如有需要,可以查看和筛选多条 AutoSupport 消息中的日志。