RTP-Audiodatenströme mit RTCP überwachen

Sie können IBM® Voice Gateway für die Überwachung von Audiostreaming konfigurieren, indem Sie RTCP (RTP Control Protocol) aktivieren. Wenn RTCP aktiviert ist, berichtet Voice Gateway netzbedingte Störungen in Berichterstellungsereignissen und über die Statusvariable vgwNetworkWarnings. Die Aktivierung von RTCP wird ab Version 1.0.0.5 unterstützt.

• Informationen zur Audiodatenstromüberwachung
• RTCP aktivieren
• Berichtete Netzinformationen

Informationen zur Audiodatenstromüberwachung

Voice Gateway verwendet das Protokoll RPT (Real-time Transport Protocol) zum Senden und Empfangen von Audiodatenströmen von einem Endsystem, wie z. B. einem SIP-Trunk. Das Protokoll RTCP (RTP Control Protocol) ist Teil der RTP-Spezifikation ( RFC 3550) und stellt Statistikdaten zur Servicequalität für RPT-Media-Streams bereit. Wenn RTCP aktiviert ist, verwendet Voice Gateway das Protokoll zur Überwachung der RTP-Netzdatenbereitstellungsmetriken, wie z. B. Abweichungen und Paketübertragungen.

Wenn die Audiodatenstromüberwachung mit RTCP aktiviert ist, berichtet Voice Gateway die folgenden Informationen:

• Netzwarnungen: Wenn ein netzbedingter Vorfall, wie z. B. eine hohe Paketverlustrate oder eine überdurchschnittliche Abweichung im RTP-Datenstrom, protokollieren SIP Orchestrator und Media Relay eine Warnung. Voice Gateway berichtet diese Warnungen ebenfalls an den folgenden Positionen:

  • Bei jedem Watson Assistant-Turnus berichtet Voice Gateway Warnungen im Ereignis des Typs Watson Assistant-Turnus, wenn die Berichterstellung für Ereignisse des Typs Watson Assistant-Turnus aktiviert ist. Voice Gateway sendet Warnungen auch über die vgwNetworkWarnings-API-Statusvariable, die an Watson Assistant oder die Serviceorchestrierungsengine gesendet wird.
  • Am Ende des Anrufs sind die Warnungen in einem warnings-Objekt in einem CDR-Ereignis enthalten, wenn die Berichterstellung für CDR-Ereignisse aktiviert ist.

• Netzzusammenfassungen: Voice Gateway stellt in einem rtpNetworkSummary-Objekt im CDR-Ereignis eine Netzzusammenfassung bereit. Die Netzzusammenfassung enthält Statistikdaten der eingehenden und abgehenden Audiodatenströme des Anrufs, einschließlich der Angaben zur durchschnittlichen und maximalen Abweichung sowie Angaben zu den Paketen.

Beachten Sie, dass Abweichungen abgehender Datenströme und Paketverluste nicht berichtet werden können, wenn das RTP-Endsystem RTCP nicht unterstützt.

Wichtig: Wenn RTCP aktiviert ist, wird ein zusätzlicher UDP-Port pro Anruf verwendet. RTP verwendet für jeden Anruf einen dynamischen Port innerhalb des über die Umgebungsvariable RTP_UDP_PORT_RANGE festgelegten Portbereichs und RTCP verwendet den nächsten Port. Wenn beispielsweise RTP den Port 16384 verwendet, verwendet RTCP den Port 16385. Vergewissern Sie sich, dass diese Ports in Ihrer Firewall offen sind. Weitere Informationen finden Sie unter Porteinstellungen für Firewalls.

RTCP aktivieren

Legen Sie für die Aktivierung von RTCP die folgenden Umgebungsvariablen unterhalb des Media Relay-Container in Ihrer Bereitstellungskonfiguration fest:

Die folgenden Beispiele veranschaulichen die Aktivierung von RTCP und ändern die Standardwerte zum Senden von Warnungen zu Abweichungen und Paketverlusten.

• Für Docker:

  media.relay:
      environment:
        ...
      - ENABLE_RTCP=true
      - RTCP_MAX_JITTER_THRESHOLD=45
      - RTCP_MAX_PACKET_LOSS_THRESHOLD=10
  

• Für Kubernetes in IBM Cloud Kubernetes Service:

    "env": [
      ...
    {
      "name": "ENABLE_RTCP",
      "value": "true"
    }, {
      "name": "RTCP_MAX_JITTER_THRESHOLD",
      "value": "45"
    }, {
      "name": "RTCP_MAX_PACKET_LOSS_THRESHOLD",
      "value": "10"
    }]
  

Berichtete Netzinformationen

Wenn RTCP aktiviert ist, berichtet Voice Gateway Warnungen während des Anrufs und aggregiert die Warnungen anschließend und stellt eine Netzzusammenfassung bereit, wenn der Anruf beendet wird.

Während des Anrufs

Voice Gateway sendet bei jedem Watson Assistant-Turnus über die Statusvariable vgwNetworkWarnings Netzwarnungen an den konfigurierten Conversation-Service oder die Serviceorchestrierungsengine. Sie können diese Statusvariable als Trigger zur Ausführung einer entsprechenden Aktion, wie z. B. Anrufübergabe oder Anrufbeendung, verwenden. Weitere Informationen zur Verwendung von Statusvariablen finden Sie unter Self-Service-Agenten mit der Voice Gateway-API verwenden.

Beispiel:

"vgwNetworkWarnings" : [
  {
    "timestamp": "2018-02-08T13:10:01Z",
    "message": "CWSMR0035W: Der Verlust eingehender RTP-Audiodatenstrompakete überschreitet mit dem Wert von 7 Prozent den Schwellenwert für maximalen Paketverlust von 5 Prozent.",
    "id": "CWSMR0035W"
  }
]

Da Ereignisse des Typs Watson Assistant-Turnus den von Watson Assistant oder der Serviceorchestrierungsengine gesendeten, vollständigen Kontext enthalten, sind auch die Ereignisse in den berichteten Warnungen enthalten. Weitere Informationen finden Sie unter Berichterstellungsereignisse des Typs Watson Assistant-Turnus von Voice Gateway.

Am Ende des Anrufs

Wenn der Anruf endet, aggregiert Voice Gateway die berichteten Netzwarnungen und stellt eine RTP-Netzzusammenfassung in einem CDR-Ereignis bereit. Wenn Sie CDR-Ereignisse generieren möchten, müssen Sie die Berichterstellung von CDR-Ereignissen in der Voice Gateway-Konfiguration aktivieren und einen REST-Server zum Speichern der Ereignisse einrichten. Weitere Informationen finden Sie unter CDR-Berichterstellungsereignisse von Voice Gateway.

RTCP fügt die folgenden JSON-Objekte innerhalb des Ereignisses hinzu:

• warnings: Der Liste mit den Warnungen werden RTP-Netzwarnungen hinzugefügt, die während des Anrufs protokolliert wurden. Weitere Informationen finden Sie unter Details zu Warnungen.
• rtpNetworkSummary: Statistikdaten zur Datenbereitstellung für die eingehenden und abgehenden RTP-Audiodatenströme. Weitere Informationen finden Sie unter Details zur RTP-Netzzusammenfassung