诊断签名 (DS) 可主动检测基于 IOS XE 的本地网关中常见的问题，并生成事件的电子邮件、系统日志或终端消息通知。 也可以安装 DS 自动收集诊断数据，并将收集到的数据转移到 Cisco TAC 案例，从而加快解决时间。

诊断签名(DS)是XML文件，包含有关问题触发事件的信息以及为通知、故障排除和解决问题而要采取的措施。 您可以使用系统日志消息、SNMP事件以及通过定期监控特定的show命令输出来定义问题检测逻辑。

操作类型包括收集 show 命令输出：

• 生成整合的日志文件

• 将文件上传到用户提供的网络位置，例如HTTPS、SCP、FTP服务器。

TAC 工程师创作 DS 文件并对其进行数字签名以确保完整性。 每个 DS 文件都有系统分配的唯一数字标识。 诊断签名查找工具(DSLT) 是查找适用签名以监控和解决各种问题的单一来源。

准备工作：

• 请勿编辑从以下位置下载的 DS 文件： DSLT 。 您修改的文件由于完整性检查错误而导致安装失败。

• 本地网关发送电子邮件通知所需的简单邮件传输协议 (SMTP) 服务器。

• 如果希望使用安全SMTP 服务器来发送电子邮件通知，请确保本地网关运行 IOS XE 17.6.1 或更高版本。

必要条件

运行IOS XE 17.6.1a或更高版本的本地网关

1. 缺省情况下诊断签名处于启用状态。

2. 将安全电子邮件服务器配置为在设备运行Cisco IOS XE 17.6.1a或更高版本时用于发送主动通知。

   configure terminal 
   call-home  
   mail-server <username>:<pwd>@<email server> priority 1 secure tls 
   end 

3. 配置环境变量ds_email以及管理员的电子邮件地址以通知您。

   configure terminal 
   call-home  
   diagnostic-signature 
   environment ds_email <email address> 
   end 

以下是运行在Cisco IOS XE 17.6.1a或更高版本上的本地网关的示例配置，用于将主动通知发送到 tacfaststart@gmail.com 使用Gmail作为安全的SMTP服务器：

我们建议您使用Cisco IOS XE Bengaluru 17.6.x或更高版本。

call-home  
mail-server tacfaststart:password@smtp.gmail.com priority 1 secure tls 
diagnostic-signature 
environment ds_email "tacfaststart@gmail.com" 

在Cisco IOS XE 软件上运行的本地网关不是典型的支持 OAuth 的基于 Web 的 Gmail 客户端，因此我们必须配置特定的 Gmail 帐户设置并提供特定权限以正确处理来自设备的电子邮件：

1. 转至 管理Google帐户 > 安全，然后打开安全性较低的应用程序访问 设置。

2. 当您收到来自 Gmail 的电子邮件，内容为“Google 已阻止他人使用非 Google 应用程序登录您的帐户”时，请回答“是，是我本人”。

安装诊断签名以进行主动监控

监控高 CPU 利用率

此DS使用SNMP OID 1.3.6.1.4.1.9.2.1.56跟踪CPU使用率5秒。 当利用率达到 75% 或更高时，它将禁用所有调试并卸载本地网关中安装的所有诊断签名。 请根据以下步骤安装签名。

1. 使用 snmp 启用SNMP的命令。 如果您没有启用，则配置 mp-服务器管理器 命令。

   show snmp 
   %SNMP agent not enabled 
   
   config t 
   snmp-server manager 
   end 
   
   show snmp 
   Chassis: ABCDEFGHIGK 
   149655 SNMP packets input 
       0 Bad SNMP version errors 
       1 Unknown community name 
       0 Illegal operation for community name supplied 
       0 Encoding errors 
       37763 Number of requested variables 
       2 Number of altered variables 
       34560 Get-request PDUs 
       138 Get-next PDUs 
       2 Set-request PDUs 
       0 Input queue packet drops (Maximum queue size 1000) 
   158277 SNMP packets output 
       0 Too big errors (Maximum packet size 1500) 
       20 No such name errors 
       0 Bad values errors 
       0 General errors 
       7998 Response PDUs 
       10280 Trap PDUs 
   Packets currently in SNMP process input queue: 0 
   SNMP global trap: enabled 
   

2. 使用下列诊断签名查找工具中的下拉选项下载 DS 64224：

   字段名	字段值
   平台	Cisco 4300、4400 ISR 系列或 Cisco CSR 1000V 系列
   产品	Webex Calling 解决方案中的 CUBE 企业版
   问题范围	性能
   问题类型	带有电子邮件通知的高 CPU 利用率。

3. 将 DS XML 文件复制到本地网关 flash 中。

   LocalGateway# copy ftp://username:password@<server name or ip>/DS_64224.xml bootflash: 

   以下示例显示如何将文件从 FTP 服务器复制到本地网关。

   copy ftp://user:pwd@192.0.2.12/DS_64224.xml bootflash: 
   Accessing ftp://*:*@ 192.0.2.12/DS_64224.xml...! 
   [OK - 3571/4096 bytes] 
   3571 bytes copied in 0.064 secs (55797 bytes/sec) 
   

4. 在本地网关中安装 DS XML 文件。

   call-home diagnostic-signature load DS_64224.xml 
   Load file DS_64224.xml success 

5. 使用显示 call-home 诊断签名命令以验证是否已成功安装签名。 状态栏中应该存在“已注册”值。

   show call-home diagnostic-signature  
   Current diagnostic-signature settings: 
   Diagnostic-signature: enabled 
   Profile: CiscoTAC-1 (status: ACTIVE) 
   Downloading  URL(s):  https://tools.cisco.com/its/service/oddce/services/DDCEService 
   Environment variable: 
   ds_email: username@gmail.com 

   Download DSes:

   DS ID	DS Name	Revision	状态	Last Update (GMT+00:00)
   64224	DS_LGW_CPU_MON75	0.0.10	已注册	2020-11-07 22:05:33

   触发后，此签名将卸载包括本身在内的所有正在运行的 DS。 如有必要，请重新安装DS 64224以继续监控本地网关上的CPU使用率过高。

监控SIP 干线注册

此 DS 每 60 秒检查一次带有Webex Calling云的本地网关 SIP 干线的注销情况。 一旦检测到注销事件，它将生成电子邮件和系统日志通知，并在发生两次注销事件后自行卸载。 使用以下步骤安装签名：

1. 使用下列诊断签名查找工具中的下拉选项下载 DS 64117：

   字段名	字段值
   平台	Cisco 4300、4400 ISR 系列或 Cisco CSR 1000V 系列
   产品	Webex Calling 解决方案中的 CUBE 企业版
   问题范围	SIP-SIP
   问题类型	带有电子邮件通知的 SIP 干线注销。

2. 将 DS XML 文件复制到本地网关。

   copy ftp://username:password@<server name or ip>/DS_64117.xml bootflash: 

3. 在本地网关中安装 DS XML 文件。

   call-home diagnostic-signature load DS_64117.xml 
   Load file DS_64117.xml success 
   LocalGateway#  

4. 使用显示 call-home 诊断签名命令以验证是否已成功安装签名。 状态列的值必须为“已注册”。

监控异常呼叫断开

该 DS 每 10 分钟使用一次 SNMP 轮询，检测 SIP 错误代码为 403、488 和 503 的异常呼叫断开连接。  如果自上次投票以来，错误计数增量大于或等于 5，它将生成系统日志和电子邮件通知。 请根据以下步骤安装签名。

1. 使用 snmp检查是否启用SNMP的 命令。 如果未启用，请配置 mp-服务器管理器 命令。

   show snmp 
   %SNMP agent not enabled 
    
   
   config t 
   snmp-server manager 
   end 
   
   show snmp 
   Chassis: ABCDEFGHIGK 
   149655 SNMP packets input 
       0 Bad SNMP version errors 
       1 Unknown community name 
       0 Illegal operation for community name supplied 
       0 Encoding errors 
       37763 Number of requested variables 
       2 Number of altered variables 
       34560 Get-request PDUs 
       138 Get-next PDUs 
       2 Set-request PDUs 
       0 Input queue packet drops (Maximum queue size 1000) 
   158277 SNMP packets output 
       0 Too big errors (Maximum packet size 1500) 
       20 No such name errors 
       0 Bad values errors 
       0 General errors 
       7998 Response PDUs 
       10280 Trap PDUs 
   Packets currently in SNMP process input queue: 0 
   SNMP global trap: enabled 
   

2. 使用诊断签名查找工具中的下列选项下载 DS 65221：

   字段名	字段值
   平台	Cisco 4300、4400 ISR 系列或 Cisco CSR 1000V 系列
   产品	Webex Calling 解决方案中的 CUBE 企业版
   问题范围	性能
   问题类型	使用电子邮件和系统日志通知检测 SIP 异常呼叫断开连接。

3. 将 DS XML 文件复制到本地网关。

   copy ftp://username:password@<server name or ip>/DS_65221.xml bootflash:

4. 在本地网关中安装 DS XML 文件。

   call-home diagnostic-signature load DS_65221.xml 
   Load file DS_65221.xml success 
   

5. 使用显示 call-home 诊断签名命令以验证是否已成功安装签名。 状态列的值必须为“已注册”。

安装诊断签名以解决问题

使用诊断签名 (DS) 快速解决问题。 Cisco TAC工程师创作了多个签名，可启用对给定问题进行故障诊断、检测问题发生、收集正确的诊断数据并将数据自动传输到Cisco TAC案例所需的必要调试。 诊断签名(DS)省去了手动检查问题发生的需要，使间歇性和瞬态问题的故障诊断更加容易。

您可以使用诊断签名查找工具以查找适用的签名并安装它们以自行解决给定的问题，或者您可以安装 TAC 工程师推荐的签名，作为支持服务的一部分。

以下示例说明了如何查找和安装 DS 以检测是否存在“%VOICE_IEC-3-GW： CCAPI: Internal Error (call spike threshold): IEC=1.1.181.1.29.0" 系统日志，并使用以下步骤自动收集诊断数据：

1. 配置其他 DS 环境变量ds_fsurl_prefix即收集的诊断数据上传到的Cisco TAC文件服务器路径 (cxd.cisco.com)。 文件路径中的用户名是案例编号，密码是文件上传令牌，可从支持案例管理器在以下命令中。 如果需要，可以在“支持案例管理器”的附件部分中生成文件上传令牌。

   configure terminal 
   call-home  
   diagnostic-signature 
   LocalGateway(cfg-call-home-diag-sign)environment ds_fsurl_prefix "scp://<case number>:<file upload token>@cxd.cisco.com"  
   end 

   例如：

   call-home  
   diagnostic-signature 
   environment ds_fsurl_prefix " environment ds_fsurl_prefix "scp://612345678:abcdefghijklmnop@cxd.cisco.com"  

2. 确保已使用 启用SNMP snmp 命令。 如果未启用，请配置 mp-服务器管理器 命令。

   show snmp 
   %SNMP agent not enabled 
    
    
   config t 
   snmp-server manager 
   end 

3. 确保安装高 CPU 监控 DS 64224 作为主动措施，在 CPU 利用率高时禁用所有调试和诊断签名。 使用诊断签名查找工具中的下列选项下载 DS 64224：

   字段名	字段值
   平台	Cisco 4300、4400 ISR 系列或 Cisco CSR 1000V 系列
   产品	Webex Calling 解决方案中的 CUBE 企业版
   问题范围	性能
   问题类型	带有电子邮件通知的高 CPU 利用率。

4. 使用诊断签名查找工具中的下列选项下载 DS 65095：

   字段名	字段值
   平台	Cisco 4300、4400 ISR 系列或 Cisco CSR 1000V 系列
   产品	Webex Calling 解决方案中的 CUBE 企业版
   问题范围	系统日志
   问题类型	系统日志 - %VOICE_IEC-3-GW： CCAPI: Internal Error (Call spike threshold): IEC=1.1.181.1.29.0

5. 将 DS XML 文件复制到本地网关。

   copy ftp://username:password@<server name or ip>/DS_64224.xml bootflash: 
   copy ftp://username:password@<server name or ip>/DS_65095.xml bootflash: 

6. 安装 DS 64224 以监控 CPU 占用率是否过高，然后在本地网关中安装 DS 65095 XML 文件。

   call-home diagnostic-signature load DS_64224.xml 
   Load file DS_64224.xml success 
    
   call-home diagnostic-signature load DS_65095.xml 
   Load file DS_65095.xml success 
   

7. 使用显示 call-home 诊断签名命令。 状态列的值必须为“已注册”。

   show call-home diagnostic-signature  
   Current diagnostic-signature settings: 
   Diagnostic-signature: enabled 
   Profile: CiscoTAC-1 (status: ACTIVE) 
   Downloading  URL(s):  https://tools.cisco.com/its/service/oddce/services/DDCEService 
   Environment variable: 
              ds_email: username@gmail.com 
              ds_fsurl_prefix: scp://612345678:abcdefghijklmnop@cxd.cisco.com 

   Downloaded DSes:

   DS ID	DS Name	Revision	状态	Last Update (GMT+00:00)
   64224 0:07:45	DS_LGW_CPU_MON75	0.0.10	已注册	2020-11-08
   65095 0:12:53	DS_LGW_IEC_Call_spike_threshold	0.0.12	已注册	2020-11-08

验证诊断签名执行

在以下命令中，显示 call-home 诊断签名命令更改为“正在运行”，同时本地网关执行签名中定义的操作。 的输出显示 call-home 诊断签名统计信息是验证诊断签名是否检测到相关事件并执行操作的最佳方法。 “已触发/最大/卸载”列指示给定签名触发事件的次数、为检测事件而定义的最大数量以及签名在检测到最大数量的触发事件后是否自行卸载。

show call-home diagnostic-signature  
Current diagnostic-signature settings: 
Diagnostic-signature: enabled 
Profile: CiscoTAC-1 (status: ACTIVE) 
Downloading  URL(s):  https://tools.cisco.com/its/service/oddce/services/DDCEService 
Environment variable: 
           ds_email: carunach@cisco.com 
           ds_fsurl_prefix: scp://612345678:abcdefghijklmnop@cxd.cisco.com 

Downloaded DSes:

显示 call-home 诊断签名统计信息

在诊断签名执行期间发送的通知电子邮件包含关键信息，例如问题类型、设备详细信息、软件版本、运行配置以及与对给定问题进行故障诊断相关的 show 命令输出。

卸载诊断签名

用于故障诊断的诊断签名通常定义为在检测到某些问题发生后卸载。 如果要手动卸载签名，请从 的输出检索DS ID Call-Home诊断-签名 命令并运行以下命令：

call-home diagnostic-signature deinstall <DS ID> 

例如：

call-home diagnostic-signature deinstall 64224 

基于在部署中常见的问题，系统会定期将新签名添加到诊断签名查找工具中。 TAC 当前不支持新建自定义签名的请求。

为了更好地管理Cisco IOS XE 网关，我们建议您通过 Control Hub 注册和管理网关。 它是可选配置。 注册后，您可以使用 Control Hub 中的配置验证选项来验证您的本地网关配置并找出任何配置问题。 目前，只有基于注册的干线支持此功能。

有关更多信息，请参阅以下内容：

• 将 Cisco IOS 受管网关注册到 Webex Cloud

• 将服务分配到受管网关

• 验证Cisco本地网关配置