진단 서명(DS)은 IOS XE 기반 로컬 게이트웨이에서 일반적으로 관찰되는 문제를 사전에 감지하고 이벤트에 대한 이메일, syslog 또는 터미널 메시지 알림을 생성합니다. 또한, DS를 설치하여 진단 데이터 수집을 자동화하고 수집한 데이터를 Cisco TAC 사례로 전송하여 해결 시간을 가속화할 수 있습니다.

진단 서명(Diagnostic Signatures, DS)은 문제 트리거 이벤트에 대한 정보 및 문제를 알리고, 문제를 해결하고, 해결하기 위해 취할 작업에 대한 정보를 포함하는 XML 파일입니다. syslog 메시지, SNMP 이벤트 및 특정 표시 명령 출력의 주기적 모니터링을 통해 문제 탐지 논리를 정의할 수 있습니다.

작업 유형에는 show 명령 출력 수집이 포함됩니다.

• 통합된 로그 파일 생성

• HTTPS, SCP, FTP 서버와 같은 사용자가 제공한 네트워크 위치에 파일을 업로드합니다.

TAC 엔지니어는 DS 파일을 작성하고 무결성 보호를 위해 디지털 서명합니다. 각 DS 파일에는 시스템이 지정한 고유한 숫자 ID가 있습니다. 진단 서명 조회 도구 (DSLT)는 다양한 문제를 모니터링하고 해결하기 위해 적용 가능한 서명을 찾을 수 있는 단일 소스입니다.

시작하기 전에:

• 다운로드한 DS 파일을 편집하지 마십시오. DSLT . 수정하는 파일은 무결성 검사 오류로 인해 설치에 실패합니다.

• 로컬 게이트웨이에서 이메일 알림을 보내는 데 필요한 SMTP(Simple Mail Transfer Protocol) 서버.

• 이메일 알림에 보안 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 Software에서 실행되는 로컬 게이트웨이는 OAuth를 지원하는 일반적인 웹 기반 Gmail 클라이언트가 아니므로 특정 Gmail 계정 설정을 구성하고 특정 권한을 제공하여 장치의 이메일이 올바르게 처리되도록 해야 합니다.

1. (으)로 이동 Google 계정 > 보안을 관리하고 덜 안전한 앱 액세스 설정을 켭니다.

2. Gmail에서 "Google에서 다른 사용자가 Google 이외의 앱을 사용하여 귀하의 계정에 로그인하지 못하도록 차단했습니다."라는 이메일을 수신하면 "예, 본인입니다."라고 응답합니다.

사전 모니터링을 위한 진단 서명 설치

높은 CPU 사용률 모니터링

이 DS는 SNMP OID 1.3.6.1.4.1.9.2.1.56을 사용하여 5초 동안 CPU 사용률을 추적합니다. 사용률이 75% 이상에 도달하면 모든 디버그를 비활성화하고 로컬 게이트웨이에 설치된 모든 진단 서명을 제거합니다. 서명을 설치하려면 아래 단계를 따르십시오.

1. 사용 SNMP 표시 명령을 사용하여 SNMP를 활성화합니다. 활성화하지 않는 경우, SNMP 서버 매니저 명령어

   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 Enterprise
   문제 범위	성능
   문제 유형	이메일 알림과 함께 높은 CPU 사용률.

3. DS XML 파일을 로컬 게이트웨이 플래시로 복사합니다.

   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. 사용 통화-홈 진단-서명 표시 명령을 실행하여 서명이 성공적으로 설치되었는지 확인합니다. 상태 열에는 "등록됨" 값이 표시되어야 합니다.

   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 

   DSes 다운로드:

   DS ID	DS 이름	개정	상태	마지막 업데이트(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 트렁크의 등록 취소를 확인합니다. 등록 취소 이벤트가 감지되면 이메일 및 syslog 알림을 생성하고 등록 취소가 두 번 발생하면 자동으로 제거됩니다. 아래 단계를 사용하여 서명을 설치합니다.

1. 다음과 같이 진단 서명 검색 도구에서 다음 드롭다운 옵션을 사용하여 DS 64117를 다운로드합니다.

   필드명	필드 값
   플랫폼	Cisco 4300, 4400 ISR 시리즈 또는 Cisco CSR 1000V 시리즈
   제품	Webex Calling 솔루션의 CUBE Enterprise
   문제 범위	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. 사용 통화-홈 진단-서명 표시 명령을 실행하여 서명이 성공적으로 설치되었는지 확인합니다. 상태 열에는 "등록됨" 값이 있어야 합니다.

비정상적인 통화 연결 끊김 모니터링

이 DS는 10분마다 SNMP 폴링을 사용하여 SIP 오류 403, 488 및 503으로 비정상적인 통화 연결 끊기를 탐지합니다.  오류 수 증가가 마지막 폴링에서 5보다 크거나 같으면 시스템 로그 및 이메일 알림을 생성합니다. 서명을 설치하려면 아래 단계를 따르십시오.

1. 사용 SNMP 표시 명령을 사용하여 SNMP가 활성화되었는지 확인합니다. 이 옵션이 활성화되지 않은 경우, SNMP 서버 매니저 명령어

   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 Enterprise
   문제 범위	성능
   문제 유형	이메일 및 Syslog 알림을 사용하여 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. 사용 통화-홈 진단-서명 표시 명령을 실행하여 서명이 성공적으로 설치되었는지 확인합니다. 상태 열에는 "등록됨" 값이 있어야 합니다.

문제 해결을 위해 진단 서명 설치

DS(진단 서명)를 사용하여 문제를 신속하게 해결합니다. Cisco TAC 엔지니어는 주어진 문제를 해결하고, 문제 발생을 감지하고, 올바른 진단 데이터 세트를 수집하고, Cisco TAC 사례로 데이터를 자동으로 전송하는 데 필요한 디버그를 활성화하는 몇 가지 서명을 작성했습니다. 진단 서명(DS)은 문제 발생을 수동으로 확인할 필요가 없으며 간헐적 및 일시적 문제의 문제를 훨씬 쉽게 해결할 수 있습니다.

다음을 사용할 수 있습니다. 진단 서명 조회 도구 해당하는 서명을 찾아 설치하여 주어진 문제를 자체적으로 해결하거나, 지원 서비스의 일부로 TAC 엔지니어가 권장하는 서명을 설치할 수 있습니다.

다음 항목을 탐지하기 위해 DS를 찾고 설치하는 방법의 예제는 다음과 같습니다. “%VOICE_IEC-3-GW: CCAPI: 내부 오류 (통화 spike 임계값): IEC=1.1.181.1.29.0" syslog 및 다음 단계를 사용하여 진단 데이터 수집을 자동화합니다.

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 표시 명령어 이 옵션이 활성화되지 않은 경우, SNMP 서버 매니저 명령어

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

3. 높은 CPU 사용률 시간 동안 모든 디버그 및 진단 서명을 비활성화하기 위한 사전 조치로 높은 CPU 모니터링 DS 64224를 설치해야 합니다. 진단 서명 검색 도구에서 다음 옵션을 사용하여 DS 64224을 다운로드합니다.

   필드명	필드 값
   플랫폼	Cisco 4300, 4400 ISR 시리즈 또는 Cisco CSR 1000V 시리즈
   제품	Webex Calling 솔루션의 CUBE Enterprise
   문제 범위	성능
   문제 유형	이메일 알림과 함께 높은 CPU 사용률.

4. 진단 서명 검색 도구에서 다음 옵션을 사용하여 DS 65095을 다운로드합니다.

   필드명	필드 값
   플랫폼	Cisco 4300, 4400 ISR 시리즈 또는 Cisco CSR 1000V 시리즈
   제품	Webex Calling 솔루션의 CUBE Enterprise
   문제 범위	시스로그
   문제 유형	Syslog - %VOICE_IEC-3-GW: CCAPI: 내부 오류 (통화 spike 임계값): 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. 높은 CPU 모니터링 DS 64224를 설치한 후 로컬 게이트웨이에 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. 다음을 사용하여 서명이 성공적으로 설치되었는지 확인합니다. 통화-홈 진단-서명 표시 명령. 상태 열에는 "등록됨" 값이 있어야 합니다.

   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 

   다운로드된 DSes:

   DS ID	DS 이름	개정	상태	마지막 업데이트(GMT+00:00)
   64224 00:07:45	DS_LGW_CPU_MON75	0.0.10	등록됨	2020-11-08
   65095 00:12:53	DS_LGW_IEC_Call_spike_threshold	0.0.12	등록됨	2020-11-08

진단 서명 실행 확인

다음 명령에서 "상태" 열은 통화-홈 진단-서명 표시 로컬 게이트웨이가 서명 내에 정의된 작업을 실행하는 동안 명령은 "실행 중"으로 변경됩니다. 의 출력 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 

다운로드된 DSes:

콜-홈 진단-서명 통계 표시

진단 서명 실행 중에 전송되는 알림 이메일 에는 문제 유형, 장치 세부 사항, 소프트웨어 버전, 실행 중인 구성 및 지정된 문제를 해결하는 것과 관련된 명령 출력 표시 등의 주요 정보가 포함됩니다.

진단 서명 제거

문제 해결을 위해 진단 서명 사용은 일반적으로 일부 문제 발생을 감지한 후 제거하도록 정의됩니다. 서명을 수동으로 제거하려면, 통화 홈 진단 서명 표시 명령을 실행하고 다음 명령을 실행합니다.

call-home diagnostic-signature deinstall <DS ID> 

예:

call-home diagnostic-signature deinstall 64224 

배포에서 일반적으로 관찰되는 문제를 기반으로 진단 서명 조회 도구에 새로운 서명이 주기적으로 추가됩니다. 현재 TAC는 새 사용자 정의 서명을 만드는 요청을 지원하지 않습니다.

Cisco IOS XE 게이트웨이를 보다 효율적으로 관리하려면 Control Hub를 통해 게이트웨이를 등록하고 관리하는 것이 좋습니다. 이는 선택적 구성입니다. 등록되면 Control Hub에서 구성 검증 옵션을 사용하여 로컬 게이트웨이 구성을 검증하고 구성 문제를 식별할 수 있습니다. 현재는 등록 기반 트렁크만 이 기능을 지원합니다.

자세한 내용은 다음을 참조하십시오.

• Webex 클라우드에 Cisco IOS 관리형 게이트웨이 등록

• 관리형 게이트웨이에 서비스 지정

• Cisco 로컬 게이트웨이 구성 검증