跳转到主内容

AutoSupport 清单在 ONTAP 9 中将文件集合报告为截断或跳过

Views:
92
Visibility:
Public
Votes:
0
Category:
ontap-9
Specialty:
core
Last Updated:

适用于

  • ONTAP 9
  • AutoSupport

问题描述

  • 在某些情况下,AutoSupport 数据在收集或传输(交付)过程中可能会被截断。
  • 如果内容过大,无法满足特定 AutoSupport 子系统的大小预算限制,或在传输过程中超出整体 AutoSupport 负载大小,则可能会发生截断。
  • 如果在 AutoSupport 消息中发现某些内容缺失,截断可能会影响主动和被动支持能力;但只要日志仍然保留在系统中,可以通过 SPI 手动提取日志。

发生原因

  1. 针对 AutoSupport 子系统的数据收集已超出您所用 ONTAP 版本设定的时间或大小限制
    • ONTAP 内的每个子系统都为整体 AutoSupport 内容的收集做出贡献
    • 为了确保 AutoSupport 的数据收集达到最佳和高效,每个子系统都有收集大小和时间预算,以防止任何一个子系统在某个日志或文件上花费过多时间。
  2. 整体 AutoSupport 消息传递大小已超过所用传输方式(SMTP 或 HTTPS)的最大限制
    • 默认的 SMTP 传送大小预算为 5 MB
    • 默认的 HTTPS 传送大小预算为 50 MB

解决方案

如何确定哪些 AutoSupport 数据被截断
  1. 运行 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.

  1. 要查看特定的 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-limit
  • collection-skipped-size-limit
  • collection-truncated-time-limit
  • collection-skipped-time-limit
  • delivery-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 传输更改为 HTTPS,请将 SMTP 最大大小增加到您的 SMTP 服务器支持的限制

AutoSupport 传输协议为 HTTPS

"collection-truncated-* " 和 "collection-skipped-* " 错误
  • 请记录受影响的 AutoSupport 子系统和数据文件
  • 如果您持续看到子系统内容被截断,请联系 NetApp 支持

Please contact NetApp Technical Support or log into the NetApp Support Site to create a technical case. Reference this article for further assistance.

追加信息

注:

  • 如果子系统大小限制被突破,并非所有文件都会被截断。
  • 超过子系统限制的二进制文件(7z、tgz、tar)不会被截断——它们会被完全跳过,不包含在 AutoSupport 消息中。
  • 只有 ASCII 文件(文本、XML)会被截断。
特定 AutoSupport 子系统注意事项
  • splog_latest 
    • 以下文件可能由于文件特定的大小限制而被截断,错误:collection-truncated-file-size-limit
      • sp-latest-system-event-log.txt
      • sp-latest-syslog.txt
      • sp-latest-statistics.txt
      • sp-downcontroller-syslog.txt
      • sp-downcontroller-statistics.txt
  • 示例:内容 sp-latest-system-event-log.txt 在 ONTAP 中被设置为最大 71,680 字节。

 

  • log_files
    • 以下文件通常由于特定文件预算而被截断,即 collection-truncated-file-size-limit

注意:这不是详尽列表: 

      • command-history.gz
      • mgwd.gz
      • secd.gz
      • sktrace.gz
    • 这些日志会不断更新和轮换。
      • 这些日志会在每日管理日志 AutoSupport 消息中收集
      • 此行为是预期的。
      • 如有需要,可以查看和筛选多条 AutoSupport 消息中的日志。

Sign in to view the entire content of this KB article.

New to NetApp?

Learn more about our award-winning Support

NetApp provides no representations or warranties regarding the accuracy or reliability or serviceability of any information or recommendations provided in this publication or with respect to any results that may be obtained by the use of the information or observance of any recommendations provided herein. The information in this document is distributed AS IS and the use of this information or the implementation of any recommendations or techniques herein is a customer's responsibility and depends on the customer's ability to evaluate and integrate them into the customer's operational environment. This document and the information contained herein may be used solely in connection with the NetApp products discussed in this document.