Runbook Diagnostic VoIP : Résoudre les problèmes étape par étape

L’objectif de cette page est de vous fournir un guide étape par étape pour diagnostiquer et résoudre les problèmes de connectivité VoIP. Suivre ce runbook vous permettra de résoudre de manière systématique les problèmes rencontrés, en vérifiant successivement chaque partie du réseau VoIP : réseau, SIP, RTP et endpoints.

🧠 Pourquoi utiliser un Runbook de diagnostic ?

Un Runbook de diagnostic est un outil pratique et essentiel qui vous aide à résoudre rapidement les problèmes en suivant un processus structuré. Cela permet :

De trouver plus rapidement la source du problème
D’éviter de tester les mêmes éléments plusieurs fois
D’assurer que chaque aspect du réseau VoIP est correctement vérifié

Ce guide vous permet de suivre une approche méthodique pour résoudre les problèmes courants tels que les problèmes de qualité d'appel, les appels échoués ou l'absence de son.

🔍 Diagnostic VoIP étape par étape

1️⃣ Vérification du Réseau

Vérifiez la connectivité réseau

La première étape de tout diagnostic VoIP consiste à vérifier la connectivité réseau, car les problèmes de réseau sont souvent la cause principale de nombreux dysfonctionnements VoIP.

📋 Étapes de vérification réseau :

Testez la connectivité du serveur VoIP via un ping ou un traceroute.

Commande : ping <adresse_ip_serveur_voip>
Si le ping échoue, il peut y avoir un problème de connexion réseau entre l'équipement client et le serveur.

Vérifiez la vitesse de connexion et la latence :

Utilisez un test de bande passante pour vous assurer que la latence est inférieure à 150 ms et que la bande passante est suffisante pour gérer les appels VoIP.
Utilisez des outils comme iPerf pour mesurer les performances réseau.

Vérifiez les équipements réseau (routeur, switch, pare-feu) pour vous assurer qu'aucun des ports nécessaires pour SIP et RTP (5060, 5061, 10000-20000, etc.) ne soit bloqué.

Vérifiez l'absence de congestion réseau :

Vérifiez la gigue (variation de la latence) en mesurant les temps de réponse pour voir s'ils sont réguliers.

Symptômes de problème réseau :

Latence élevée (>150 ms)
Gigue élevée (>30 ms)
Pertes de paquets supérieures à 1%

2️⃣ Vérification du SIP

Le SIP est le protocole de signalisation utilisé pour établir les appels. Si vous rencontrez des échecs d'appel ou des problèmes d'enregistrement, il est probable que le problème soit lié à la signalisation SIP.

📋 Étapes de vérification SIP :

Vérifiez la connexion SIP :

Exécutez une commande de traceroute ou utilisez un outil comme SIPp ou Wireshark pour analyser la signalisation SIP et identifier les problèmes de connexion.

Vérifiez les logs SIP :

Accédez aux logs de signalisation SIP pour vérifier si des erreurs de connexion, des échecs de négociation ou des erreurs de configuration apparaissent (ex : 404, 503).

Vérifiez la configuration du serveur SIP :

Assurez-vous que votre serveur est correctement configuré pour accepter les connexions SIP sur les bons ports (5060 pour non sécurisé, 5061 pour sécurisé via TLS).
Assurez-vous que SIP ALG (Application Layer Gateway) est désactivé dans le pare-feu ou le routeur, car il peut perturber les paquets SIP.

Testez les enregistrements SIP :

Vérifiez que les téléphones ou softphones s'enregistrent correctement sur le serveur SIP. Vous pouvez vérifier les logs d'enregistrement SIP pour voir si l'enregistrement échoue et pourquoi.

Symptômes de problème SIP :

Appels échoués avec des erreurs SIP comme 404 ou 503.
Appels en attente mais jamais connectés (signalisation bloquée).
Problèmes d’enregistrement des téléphones SIP.

3️⃣ Vérification du RTP (Real-Time Protocol)

Une fois que le SIP a réussi à établir la connexion, le RTP est utilisé pour transporter la voix (média). Des problèmes avec le flux RTP peuvent entraîner des problèmes de qualité audio ou l'absence de son.

📋 Étapes de vérification RTP :

Vérifiez les paquets RTP :

Utilisez un outil comme Wireshark pour analyser les paquets RTP et vérifier que les flux audio arrivent aux bonnes adresses IP et ports.
Vérifiez si les paquets RTP sont bien envoyés dans les deux sens (de l’appelant vers l’appelé et vice versa).

Vérifiez la configuration des ports RTP :

Assurez-vous que les ports RTP (10000-20000) sont ouverts et accessibles dans les deux sens dans le pare-feu.
Vérifiez la plage de ports RTP configurée dans votre serveur VoIP.

Vérifiez la qualité de la connexion RTP :

Mesurez la latence RTP, la gigue et la perte de paquets pour vous assurer que la voix ne subit pas de dégradation.

Vérifiez les codecs utilisés :

Assurez-vous que les codecs utilisés (ex : G.711, G.729, Opus) sont compatibles entre les équipements.

Symptômes de problème RTP :

Pas de son ou son coupé durant l'appel (généralement dû à un flux RTP mal acheminé ou bloqué).
Appels à faible qualité audio avec des décrochages ou des voix distordues (souvent dû à la gigue ou à la latence).
Problèmes de codec ou incompatibilité entre les équipements.

4️⃣ Vérification des Terminaux SIP (Postes Téléphoniques ou Softphones)

Les terminaux SIP sont les équipements finaux (téléphones IP, softphones, etc.) utilisés pour passer ou recevoir des appels VoIP. Un problème de configuration ou de connectivité avec un terminal SIP peut également causer des échecs d’appel ou des problèmes de qualité.

📋 Étapes de vérification des terminaux SIP :

1. Vérifiez l’enregistrement du terminal :

◦ Assurez-vous que les téléphones ou softphones sont bien enregistrés sur le serveur SIP et qu’ils utilisent les bonnes informations d’identification (nom d’utilisateur, mot de passe, etc.).

2. Vérifiez les paramètres réseau des terminaux SIP :

◦ Vérifiez si le téléphone ou softphone est connecté au bon réseau (Wi-Fi ou Ethernet).

◦ Testez la bande passante et la latence entre le terminal SIP et le serveur afin de vous assurer qu’il n’y a pas de problème de connectivité réseau.

3. Testez l’audio sur le terminal SIP :

◦ Passez un appel de test pour vérifier si la qualité audio est correcte (voix claire, pas de coupures, pas de bruit de fond).

4. Vérifiez les logs du terminal SIP :

◦ Si le problème persiste, examinez les logs du terminal SIP afin de détecter d’éventuelles erreurs de configuration ou de réseau.

Symptômes d’un problème lié aux terminaux SIP :

· Appel échoué sur un téléphone spécifique.

· Qualité audio dégradée ou absence de son sur un téléphone ou un softphone.

· Problèmes de connectivité sur un terminal particulier (ex : téléphone qui ne s’enregistre pas, déconnexions répétées).

⚠️ Erreurs fréquentes et solutions

1️⃣ Problème : "Pas de son" ou audio coupé

Cause possible : Problème de connectivité RTP ou de configuration des ports.
Solution : Vérifiez les ports RTP (10000-20000) et la configuration du NAT. Assurez-vous que les paquets RTP circulent librement.

2️⃣ Problème : Appels échoués avec erreur SIP

Cause possible : Erreur de signalisation ou mauvais enregistrement.
Solution : Vérifiez les logs SIP pour identifier l’erreur spécifique. Assurez-vous que le SIP ALG est désactivé sur le routeur et que l'authentification SIP est correcte.

3️⃣ Problème : Qualité audio dégradée

Cause possible : Gigue élevée ou latence trop importante.
Solution : Appliquez le QoS sur votre réseau pour prioriser le trafic VoIP et assurez-vous que votre connexion réseau est suffisamment stable.

✅ Bonnes pratiques de diagnostic VoIP

✔ Testez le réseau avant tout appel : vérifiez la connectivité, la bande passante et la latence.

✔ Vérifiez les enregistrements SIP et les logs de signalisation avant de vérifier le flux RTP.

✔ Surveillez la qualité audio pendant les appels pour identifier les problèmes de gigue ou de perte de paquets.

✔ Gardez une trace des erreurs fréquentes et configurez des alertes pour les résoudre rapidement.