Surveillance des flux audio RTP à l'aide de RTCP

Vous pouvez configurer IBM® Voice Gateway pour surveiller les flux audio en activant RTCP (RTP Control Protocol). Lorsque RTCP est activé, Voice Gateway signale les incidents liés au réseau dans les événements de génération de rapport et dans la variable d'état vgwNetworkWarnings. L'activation de RTCP est prise en charge dans la version 1.0.0.5 et dans les versions ultérieures.

• A propos de la surveillance des flux audio
• Activation de RTCP
• Informations réseau signalées

A propos de la surveillance des flux audio

Voice Gateway utilise RTP (Real-time Transport Protocol) pour envoyer et recevoir des flux audio depuis un système d'extrémité, tel qu'une liaison SIP. RTCP fait partie de la spécification RTP (RFC 3550) et fournit des statistiques de qualité de service (QoS) pour les flux média RTP. Lorsque RTCP est activé, Voice Gateway utilise le protocole pour surveiller les statistiques de distribution de données réseau RTP, telles que la transmission de gigue et de paquet.

Lorsque la surveillance des flux audio avec RTCP est activée, Voice Gateway renvoie les informations suivantes :

• Avertissements réseau : lorsqu'un incident réseau se produit, par exemple, une lourde perte de paquets ou une gigue moyenne élevée dans le flux RTP, SIP Orchestrator et Media Relay consignent un avertissement. Voice Gateway signale également ces avertissements aux emplacements suivants :

  • Pour chaque échange Watson Assistant, Voice Gateway signale des avertissements dans l'événement d'échange Watson Assistant, si la génération de rapports sur les événements d'échange Watson Assistant est activée. Voice Gateway envoie également les avertissements sur la variable d'état de l'API vgwNetworkWarnings, qui est envoyée à Watson Assistant ou au moteur d'orchestration de service.
  • A la fin de l'appel, les avertissements sont inclus dans un objet warnings dans un événement d'enregistrement des détails d'appel, si la génération de rapports sur les événements CDR est activée.

• Récapitulatifs de réseau : Voice Gateway fournit un récapitulatif de réseau dans un objet rtpNetworkSummary au sein de l'événement d'enregistrement des détails d'appel. Le récapitulatif de réseau contient des statistiques provenant des flux audio entrants et sortants dans l'appel, y compris la gigue maximale et moyenne et les informations de paquet.

Notez que si le système d'extrémité RTP ne prend pas en charge RTCP, la gigue de flux sortant et la perte de paquet ne peuvent pas être signalées.

Important : L'activation de RTCP utilise un port UDP supplémentaire par appel. Pour chaque appel, RTP utilise un port dynamique compris dans la plage définie dans la variable d'environnement RTP_UDP_PORT_RANGE, et RTCP utilise le port suivant. Par exemple, si RTP utilise le port 16384, RTCP utilisera le port 16385. Assurez-vous que ces ports sont ouverts dans votre pare-feu. Pour plus d'informations, voir Paramètres de port pour les pare-feux.

Activation de RTCP

Pour activer RTCP, définissez les variables d'environnement suivantes sous le conteneur Media Relay dans votre configuration de déploiement :

Les exemples suivants activent RTCP et modifient les valeurs par défaut relatives à l'envoi d'avertissements signalant la gigue ou la perte de paquet.

• Pour Docker :

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

• Pour Kubernetes dans 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"
    }]
  

Informations réseau signalées

Lorsque RTCP est activé, Voice Gateway signale les avertissements liés au réseau durant l'appel, les regroupe, puis fournit un récapitulatif de réseau lorsque l'appel prend fin.

Durant l'appel

Pour chaque échange de conversation, Voice Gateway envoie des avertissements de réseau au service Watson Assistant configuré ou au moteur d'orchestration de service dans la variable d'état vgwNetworkWarnings. Vous pouvez utiliser cette variable d'état en tant que déclencheur pour effectuer une action appropriée, comme le transfert ou l'arrêt de l'appel. Pour plus d'informations sur l'utilisation des variables d'état, voir Programmation d'agents en libre-service à l'aide de l'API Voice Gateway.

Exemple :

"vgwNetworkWarnings" : [
  {
    "timestamp": "2018-02-08T13:10:01Z",
    "message": "CWSMR0035W: The inbound RTP audio stream packet loss of 7 percent exceeds the maximum packet loss threshold of 5 percent.",
    "id": "CWSMR0035W"
  }
]

Dans la mesure où les événements d'échange Watson Assistant contiennent l'ensemble du contexte tel qu'il a été envoyé par Watson Assistant ou par un moteur d'orchestration de service, les événements incluent également les avertissements signalés. Pour plus d'informations, voir Génération de rapports sur les événements d'échange Watson Assistant par Voice Gateway.

A la fin de l'appel

Lorsque l'appel prend fin, la passerelle voix agrège les avertissements réseau signalés et fournit un récapitulatif de réseau RTP dans un événement d'enregistrement des détails d'appel (CDR). Pour générer des événements CDR, vous devez activer la génération de rapports sur les événements CDR dans la configuration de Voice Gateway et configurer un serveur REST pour stocker les événements. Pour plus d'informations, voir Génération de rapports sur les événements CDR depuis Voice Gateway.

RTCP ajoute les objets JSON suivants dans l'événement :

• warnings : ajoute des avertissements de réseau RTP à la liste des avertissements qui ont été consignés durant l'appel. Voir Détails d'avertissement.
• rtpNetworkSummary : statistiques de distribution des données pour les flux audio RTP entrants et sortants. Voir Détails de récapitulatif de réseau RTP.