Probleemoplossing voor CUBE via Collaboration Solution Analyzer

Inleiding

Dit document beschrijft tools voor loganalyzer en SIP-profieltester voor probleemoplossing in CUBE met behulp van het Collaboration Solutions Analyzer-portal.

Vereisten

Cisco raadt kennis van de volgende onderwerpen aan:

• Cisco Unified Border Element (CUBE) voor ondernemingen.
• Session Initiation Protocol (SIP).
• Logboekverzameling CUBE (debugging).

Aan de slag

Collaboration Solutions Analyzer (CSA) is een reeks tools die zijn ontworpen om uw collaboration-oplossing tijdens de hele levenscyclus te ondersteunen. Het helpt bij het identificeren van problemen en biedt zo nodig corrigerende actieplannen, die helpen bij elke fase van de samenwerkingsoplossing.

Navigeer naar de Collaboration Solution Analyzer op https://cway.cisco.com/csa-new/#/home

Opmerking: Chrome browser zorgt ervoor dat de tool optimaal functioneert.

Overwegingen

De tools zijn ontworpen voor een CUBE-apparaat dat SIP-to-SIP gesprekken verwerkt. Een ander spraakprotocol wordt niet ondersteund door de tools.

Log Analyzer gebruikt CUBE logs (op basis van SIP-berichtdebugging) voor het parseren.

Als u hulp nodig hebt met een ander spraakprotocol, gebruikt u de Cisco Support Assistant voor TAC-afspraken op https://supportassistant.cisco.com

Platformbeschrijving

Het CSA-platform biedt deze CUBE-tools:

• Log Analyzer - Upload logs van CUBE en andere collaboration-apparaten om problemen automatisch te detecteren, op te lossen en op te lossen.
• SIP Profile Tester - Validate SIP Profile Configuration.

CSA-startpunt

Loganalyzer

Het hulpmiddel van de Analyzer van het Logboek laat beheerders toe om de vraag te onderzoeken die signaleren door het apparaat CUBE wordt behandeld. Het biedt een uitgebreide analyse van logbestanden, waaronder:

• Informatie over gespreksbeen
• Ladderdiagram
• Signalering

Opmerking: CUBE-debugging (debug cisco-berichten) van een aanroep die door de CUBE is verwerkt, moet eerst worden verzameld en opgeslagen in een tekstbestand. Alleen SIP-debug en geen andere uitvoer, zoals showopdrachten, moet in dit tekstbestand worden opgenomen.

Logbestanden uploaden in CUBE

Navigeer naar de Collaboration Solution Analyzer op https://cway.cisco.com/csa-new/#/home

Selecteer vervolgens het gereedschap door op Upload-bestanden te klikken in het gedeelte Log Analyzer.

Log Analyzer Home

Het platform toont het gereedschapsscherm waar een bestand geselecteerd of gesleept kan worden.

Upload van loganalyzer

Klik op de knop Upload om het uploaden van het bestand voor analyse te voltooien.

Uploadbestand voor loganalyzer

Selecteer na het uploaden van het bestand naar het gereedschap de bestanden die u wilt analyseren door het bijbehorende vakje aan te vinken en klik vervolgens op de knop Analyse uitvoeren.

• Het systeem stelt het producttype in op CUBE.
• Meer dan één bestand kan tijdens dezelfde sessie worden geanalyseerd.

Producttype loganalyzer

Het gereedschap analyseert alle signaleringsoproepen die in het tekstbestand worden opgenomen en geeft een samenvatting van de geïdentificeerde aanroepbenen. U kunt dan twee filters toepassen:

• Zoeken - Filter gesprekssessies op specifieke gegevens, zoals gedraaide nummers.
• Zoek op ‘Verbreken Reden - Filter gesprekssessies gebaseerd op de reden voor het verbreken van de verbinding.

Gespreksfilter voor loganalyse 

Om verder te gaan met de gedetailleerde analyse, selecteert u de gesprekssessielijn waarop u zich wilt richten, en de tool toont de volledige analyse die de Call Leg Information, Ladder Diagram en Signaling toont.

Informatie over gespreksgroepen

De eerste fase presenteert de Call Leg Information, die het overzicht van de oproep toont:

• Type SIP-oproepbeen
• Van - Verkregen uit van SIP kopbal van het INVITE bericht.
• Aan - Verkregen van de kop TO SIP van het INVITE-bericht.
• Signaleringsbron - IP-adres en poort van het bronapparaat. Verkregen van de VIA SIP-header van het INVITE-bericht.
• Bestemming signalering - IP-adres en poort van doelapparaat. Verkregen van de URI SIP-kop van het INVITE-bericht.
• Bel-ID - Verkregen van de SIP CALL-ID-header van het INVITE-bericht.
• Call leg verbindt - Call sessie timestamp.

Informatie over gesprekskoppeling voor loganalyzer

In deze sectie kunnen Ladder-tags worden ingeschakeld om berichten in het Ladder Diagram te markeren. De toepassing heeft 2 velden:

• ID - Voer de specifieke parameter in die u wilt markeren.
• Beschrijving - Een beschrijving van de parameter toevoegen.

Klik op de knop Toevoegen om het proces te voltooien.

Log Analyzer Ladder Tags 

Ladderdiagram

In de tweede fase wordt een Ladder Diagram getoond, waarin de SIP-berichten die tijdens de oproep worden uitgewisseld, visueel worden weergegeven. De berichten zijn kleurgecodeerd voor eenvoudige identificatie:

• Blauwe kleur - SIP INVITE-berichten.
• Groene kleur - SIP 200 OK en ACK berichten.
• Rode kleur - SIP BYE-berichten.

Als u een kopie van het diagram wilt downloaden, klikt u op de knop Download Ladder. Het diagram wordt gedownload en als PNG-beeldbestand opgeslagen. Deze optie is alleen beschikbaar bij gebruik van de Google Chrome-browser.

Diagram van loganalysatorlader

Dit hulpmiddel staat de beheerder toe om SIP-berichten te openen en hun inhoud te bekijken. Klik op een bericht om het te openen.

Diagrambericht voor loganalyzer

De beheerder kan Ladder Tags toevoegen om SIP-berichten te visualiseren met een onderscheidend stipteken in de sectie Call Leg Information. Om het even welke parameter in het SIP bericht kan voor de markering worden gebruikt.

In dit voorbeeld wordt een IP-adres gebruikt voor de parameter ID en wordt een beschrijving toegevoegd. SIP-berichten die het IP-adres bevatten, worden gemarkeerd met een stippelteken om ze van andere berichten te onderscheiden.

Log Analyzer Ladder Tags 1

Log Analyzer Ladder Tags 2

Een andere filter die kan worden gebruikt om SIP-berichten van andere berichten te onderscheiden is een spraakcodec.

Log Analyzer Ladder Tags 3

Log Analyzer Ladder Tags 4

Signalering

Het laatste stadium is de signalering, die de SIP-berichten voor beide CUBE-benen (inkomend en uitgaand) weergeeft. Het bevat de bron en de bestemming IP adressen. Klik om het bericht te bekijken.

Signalering van loganalyzer

Bericht over signalering van loganalyse

Diagnostiek

Alle gegevens die uit logbestanden worden geparsed, worden uitgevoerd tegen diagnostische handtekeningen die bekende defecten, vaak gesignaleerde problemen of verkeerde configuraties identificeren en een correctief actieplan bieden.

Zodra een in de logbestanden opgenomen oproep is geselecteerd om de samenvattende analyse van de oproep weer te geven, geeft het CSA-platform de sectie Diagnostiek weer, die deze informatie bevat:

• Problemen gevonden
• Ontbrekende informatie
• Potentieel probleem

Een knevelknop kan worden geactiveerd om alleen defecten te filteren en weer te geven.

Log Analyzer Diagnostics Home

Overzicht van loganalyzer

CUBE-pakketvastlegging

Packet Capture is een bestandsbuffer die is gemaakt om een kopie van de feitelijke pakketten te verzamelen op een CUBE-netwerkinterface of een spraak-netwerkapparaat. Dit bestand kan worden geopend en geanalyseerd door software voor netwerkanalyse, zoals Wireshark.

De tool Log Analyzer is verbeterd met een Packet Capture analyzer die PDF-bestandsformaten of pcapng-bestandsformaten kan verwerken, en een samenvatting van sessie- en netwerkstatistieken kan geven die uit oproepen zijn verzameld.

Het Packet Capture bestand moet naar het Log Analyzer gereedschap geüpload worden op dezelfde manier als het CUBE logbestand. Het systeem bepaalt het producttype als PCAP.

Log analyse van pakketvastlegging bestand

Nadat de knop Run analysis is geactiveerd, analyseert het gereedschap Log Analyzer de informatie en geeft u een samenvatting van de opgenomen sessies in twee kolommen:

• RTP-stromen
• TCP/UDP-stromen

Opmerking: als de pakketopname SRTP-stromen omvat, wordt deze weergegeven in de kolom 'RTP-stromen' en wordt een netwerkanalyse uitgevoerd. Het audiogedeelte van een SRTP-stroom wordt niet gedecodeerd.

Selecteer een sessie in de kolom RTP-stromen en het gereedschap geeft de RTP-stroomstatussen voor die verbinding weer. Als de stroom door de netwerkomstandigheden wordt beïnvloed, wordt de Packet Loss-parameter met rode punten gemarkeerd.

PCAP-analyse van de loganalyzer

De RTP Flow Statistics kan worden gedownload in een tekstbestandsindeling die een samenvatting van pakketverlies bevat. Klik op de knop Packet Loss om het bestand te downloaden.

Log Analyzer PCAP RTP-stream

Voor TCP/UDP-stromen geeft het systeem de samenvatting van de opgenomen sessies weer.

Log Analyzer PCAP TCP UDP-stromen

SIP-profieltester (SPT)

Session Initiation Protocol (SIP)-profielen worden gebruikt om inkomende of uitgaande SIP-berichten aan te passen om de compatibiliteit tussen verschillende apparaten te garanderen. Met de 'SIP Profile Tester' tool kunt u uw configuratie valideren voordat u deze in een live omgeving implementeert.

Het SIP Profile Tool bestaat uit 3 secties:

• Regels voor SIP-profiel - venster voor het invoegen van de te testen regels voor SIP-profiel.
• SIP-bericht om regels toe te passen - Venster om het SIP-bericht te plakken waar de regels moeten worden toegepast.
• SIP-bericht om te kopiëren van - (optioneel) venster om een SIP-bericht te plakken voor het geval dat een configuratie van een kopieerlijst wordt getest. Een configuratie van de exemplaarlijst kopieert de inhoud van een inkomende header die door een apparaat wordt ontvangen naar een uitgaande header.

Het gereedschap bevat 2 knoppen om de tests te beheren:

• Green Button - Een test uitvoeren.
• Rode knop - Instellingen opnieuw instellen en wissen.

Nadat u de groene knop hebt geselecteerd om de test uit te voeren, worden in het gereedschap de volgende opties weergegeven:

• Rode knop - Nieuwe test
• Blauwe knop - Inloop weergeven

Markering van de resultaten van het oorspronkelijke/gewijzigde SIP-bericht:

• Blauwe Kleur - Aangepaste SIP-koppen of SDP Body worden in beide berichtgebieden blauw gemarkeerd.
• Green Color - added SIP-koppen of SDP Body worden groen gemarkeerd in het gewijzigde SIP-berichtresultaat alleen.
• Rode kleur - Verwijderde SIP-koppen of SDP-tekst wordt alleen rood gemarkeerd in het oorspronkelijke SIP-berichtresultaat.

SIP PROFILE Home

Voorbeeld van voorgebouwd SIP-profiel

De tool biedt vooraf samengestelde voorbeelden om het testen te vereenvoudigen. Bovenaan elk venster staat een toepassingsvak voor het selecteren van deze voorbeelden.

Zo gebruikt u een vooraf gedefinieerde configuratie:

1. Klik op Een voorgebouwde regelset laden en selecteer Toevoegen: SIP-kop.
2. Klik op Een voorbeeldSIP-bericht laden en selecteer UITNODIGEN (geen SDP).
3. Selecteer de groene knop Test uitvoeren om de test uit te voeren.

SIP-PROFIEL, voorgebouwd

Het gereedschap geeft een nieuw scherm weer met de resultaten van de test:

Gewijzigd SIP-bericht

ADDED (GREEN) - Diversion: <sip:8675309@cisco.com

Voorbeeld van SIP-profiel, voorgebouwd

Dit is een voorbeeld van de markering wijzigen/toevoegen/verwijderen:

Regels voor SIP-profiel

rule 100 request ANY sip-header Diversion Add "Diversion: <sip:8675309@cisco.com>"
rule 200 request ANY sip-header P-Asserted-Identity modify "sip:4444444444@" "sip:5555555555@"
rule 300 request ANY sip-header P-Preferred-Identity remove

SIP-bericht om regels te testen op

INVITE sip:8675309@192.168.11.10:5060 SIP/2.0
Via: SIP/2.0/TCP 192.168.10.10:5060;branch=z9hG4bK16242110
Via: SIP/2.0/UDP 192.168.10.9:5060;branch=z9hG4bK00002579
From: "CallerID_Name" <sip:123456789@192.168.10.10>;tag=4EDF0DD8-CA0
To: <sip:8675309@192.168.11.10>
Call-ID: D7E43511-335111EF-8578BA40-6B7EBADB@192.168.10.10
Session-ID: 2d390a8000105000a000247e1266c26d;remote=3b954a1e00105000a0006c416a369498
Cisco-Guid: 3622027175-0860951023-2238888512-1803467483
Cseq: 101 INVITE
Allow: INVITE, OPTIONS, BYE, CANCEL, ACK, PRACK, UPDATE, REFER, SUBSCRIBE, NOTIFY, INFO, REGISTER
Allow-Events: telephone-event,kpml,dialog
Supported: 100rel,timer,resource-priority,replaces
Supported: sdp-anat
Require: timer
Subject: SIP Profile Test
Session: Media
User-Agent: Cisco-SIPGateway/IOS-17.14.1a
Date: Thu, 27 Jun 2024 00:20:07 GMT
Timestamp: 1719447607
Expires: 180
Min-SE: 1800
Session-Expires: 1800;refresher=uac
Max-Forwards: 69
Contact: <sip:1111111111@192.168.10.10:5060;transport=tcp>
Diversion: <sip:2222222222@192.168.10.10>;privacy=off;reason=unconditional;counter=1;screen=no
Remote-Party-ID: "CallerID_Name" <sip:3333333333@192.168.10.10>;party=calling;screen=no;privacy=off
P-Asserted-Identity: "CallerID_Name" <sip:4444444444@192.168.10.10>
P-Preferred-Identity: "CallerID_Name" <sip:5555555555@192.168.10.10>
CustomHeader: "CallerID_Name" <sip:7777777777@192.168.10.10>
Accept: application/sdp
Content-Disposition: session;handling=required
Content-Length: 0

SIP-profiel Aanpassen Voorbeeld toevoegen

Klik op Test uitvoeren om het resultaat te bekijken.

Oorspronkelijk SIP-bericht

MODIFIED (BLUE) - P-Asserted-Identity: "CallerID_Name" 
    
     
     4444444444@192.168.10.10> 
     
 
    REMOVED (RED) - P-Preferred-Identity: "CallerID_Name" <sip:5555555555@192.168.10.10>

Gewijzigd SIP-bericht

MODIFIED (BLUE) - P-Asserted-Identity: "CallerID_Name" <sip:5555555555@192.168.10.10>
ADDED (GREEN) - Diversion: <sip:8675309@cisco.com>

SIP-profiel Aanpassen Voorbeeld verwijderen 2

SIP-profiel van Copylist

Voor het kopiëren van inhoud van een inkomende header die een apparaat ontvangt naar een uitgaande header (SIP-copylist), kunnen deze gereedschapsinvoeringen worden gebruikt:

• Stroomschema: inkomend SIP-bericht — > CUBE — > Gewijzigd SIP-bericht

• Peer SIP-bericht naar kopiëren van - SIP-bericht naar kopiëren van.
• SIP - bericht aan testregels op SIP - bericht om regels toe te passen.

Om het Peer SIP-bericht in te schakelen voor kopiëren vanaf de sectie, moet de optie Invoer peer kopie tonen ingeschakeld zijn. U kunt op Invoer voor kopiëren verbergen klikken om deze sectie te verbergen.

SIP PROFIEL Copylist Home

Dit is een voorbeeld van SIP-regels, inkomende en gewijzigde SIP-berichten:

SIP-profielregels.

request INVITE peer-header sip To copy “sip:(.*)@” u01
request INVITE sip-header SIP-Req-URI modify “sip:(.*)@” sip:\u01@

SIP-bericht om regels toe te passen.

Sent:
INVITE sip:235678@10.16.0.5:5060 SIP/2.0
Via: SIP/2.0/UDP 192.0.2.0:5060;branch=z9hG4bKA7155C
From: "Cisco" <sip:1234@10.16.0.3>;tag=B125CE72-1184
To: <sip:5678@10.16.0.5>
Call-ID: 783557DF-193811EF-A4C1B962-D5D3EC18@192.0.2.0
Supported: 100rel,timer,resource-priority,replaces,sdp-anat
Min-SE:  1800
Allow: INVITE, OPTIONS, BYE, CANCEL, ACK, PRACK, UPDATE, REFER, SUBSCRIBE, NOTIFY, INFO, REGISTER
CSeq: 101 INVITE
Timestamp: 1716577979
Contact: <sip:1234@192.0.2.0:5060>
Expires: 180
Allow-Events: telephone-event
Max-Forwards: 68
P-Asserted-Identity: "Cisco" <sip:9876@192.0.2.0>
Session-ID: 1629a67700105000a000d9a7fe;remote=00000000000000000000000000000000
Session-Expires:  1800
Content-Type: application/sdp
Content-Disposition: session;handling=required
Content-Length: 243

v=0
o=CiscoSystemsSIP-GW-UserAgent 3601 9082 IN IP4 192.0.2.0
s=SIP Call
c=IN IP4 192.0.2.0
t=0 0
m=audio 8402 RTP/AVP 0 101
c=IN IP4 192.0.2.0
a=rtpmap:0 PCMU/8000
a=rtpmap:101 telephone-event/8000
a=fmtp:101 0-16

SIP-bericht naar kopie van.

Received:
INVITE sip:235678@10.15.0.2:5060 SIP/2.0
Via: SIP/2.0/UDP 10.14.0.1:5060;branch=z9hG4bK16927e56b400c78
From: "Cisco" <sip:1234@10.14.0.1>;tag=156812752~757956d9-2b62-4ab0-b5c2-6b19710635db-53693198
To: <sip:5678@10.15.0.2>
Call-ID: a0f63500-1f013804-1344e15-16000e0a@10.14.0.1
Supported: 100rel,timer,resource-priority,replaces
Min-SE:  1800
User-Agent: Cisco-CUCM12.5
Allow: INVITE, OPTIONS, INFO, BYE, CANCEL, ACK, PRACK, UPDATE, REFER, SUBSCRIBE, NOTIFY
CSeq: 101 INVITE
Expires: 180
Allow-Events: presence, kpml
Supported: X-cisco-srtp-fallback,X-cisco-original-called
Call-Info: <sip:10.14.0.1:5060>;method="NOTIFY;Event=telephone-event;Duration=500"
Call-Info: <urn:x-cisco-remotecc:callinfo>;x-cisco-video-traffic-class=DESKTOP
Session-ID: 1629a67700105000885a92d9a7fe;remote=00000000000000000000000000000000
Cisco-Guid: 2700489984-0000065536-0000126777-1234102346
Session-Expires:  1800
P-Asserted-Identity: "Cisco" <sip:1234@10.14.0.1>
Remote-Party-ID: "Cisco" <sip:1234@10.14.0.1>;party=calling;screen=yes;privacy=off
Contact: <sip:1234@10.14.0.1:5060>;+u.sip!devicename.ccm.cisco.com="SEP885A92D9A7FE"
Max-Forwards: 69
Content-Length: 0

Voorbeeld van SIP-profiel

Ga verder door op de knop Test uitvoeren te klikken om de tool te starten.

Registratie kopiëren

Register: u01
Value: 5678 

Oorspronkelijk SIP-bericht

MODIFIED (BLUE) - INVITE sip:235678@10.16.0.5:5060 SIP/2.0

Gewijzigd SIP-bericht

MODIFIED (BLUE) - INVITE sip:5678@10.16.0.5:5060 SIP/2.0

Voorbeeld 2 van SIP-profiel

Een probleem melden

Bovenaan het CSA-platform kunt u in het gedeelte Report A Problem elk probleem dat in de tools is gedetecteerd, delen.

Daarnaast kan de beheerder feedback, opmerkingen of suggesties geven door een e-mail te sturen naar waar het CSA-ontwikkelingsteam de informatie verwerkt.

Probleem melden Home

Probleem melden

Drie pictogrammen zijn ingeschakeld om de gebruiker in staat te stellen om feedback te geven (megafoon pictogram), de gebruikersdocumentatie te bekijken (vraagteken pictogram) en gebruikersinstellingen te openen (cogwheel pictogram).

Pictogrammen

Verwante informatie over ondersteuning

Configuratie van debug-verzameling voor CUBE- en TDM-gateways

Configuratiehandleiding voor Cisco Unified Border Element met Cisco IOS XE 17.5

Hoofdstuk: SIP-profielen

SIP-profielen gebruiken op CUBE Enterprise Common Use Cases