Moniteur RTSP

Le moniteur RTSP (Real Time Streaming Protocol) teste la diffusion des flux vidéo et audio sur les serveurs de flot de données. Il réunit des informations sur les fichiers média et lance la lecture, la pause et l'arrêt d'une session de flot de données.

Le tableau ci-dessous répertorie les fichiers du moniteur RTSP.

Tableau 1. Fichiers du moniteur RTSP
Fichiers du moniteur	Nom ou emplacement
Exécutable du moniteur	nco_m_rtsp
Fichier de propriétés	$ISHOME/etc/props/rtsp.props
Fichier de règles	$ISHOME/etc/rules/rtsp.rules
Fichier journal	$ISHOME/log/rtsp.log

Consignes de configuration du moniteur RTSP: Le moniteur RTSP se connecte au serveur de flot de données en mode DESCRIBE ou PLAY. Il télécharge les informations ou les statistiques fournies pour les serveurs RTSP authentiques, tels que Darwin.

Mode DESCRIBE

En mode DESCRIBE, le moniteur RTSP se connecte au serveur de diffusion en flux et demande les informations sur les fichiers audio et vidéo et les flux.

Le serveur renvoie un code d'état où la valeur 200 indique un fichier téléchargeable, et où les autres valeurs indiquent la raison pour laquelle le fichier demandé n'a pas pu être lu.

Cependant, les statistiques liées à la lecture ne sont pas signalées dans ce mode. La fonction de base des serveurs qui prennent en charge RTSP peut être testée.

Mode PLAY: En mode PLAY, le moniteur RTSP se connecte au serveur de diffusion en flux de la même manière qu'en mode DESCRIBE puis lit le fichier en continu pour fournir des statistiques sur les téléchargements demandés.

Propriétés

Les options de propriétés spécifiques du moniteur RTSP sont décrites dans le tableau suivant.

Tableau 2. Options des propriétés du moniteur RTSP
Nom de la propriété	Paramètre de la propriété	Description
StreamingSocket BufferSize	entier	Taille de la mémoire tampon du socket de flux de données, comprise entre 8 et 64 ko. Valeur par défaut : 8

Configuration des tests de service du moniteur RTSP

Les paramètres de configuration du moniteur RTSP permettent de définir des tests de service.

Le tableau ci-dessous répertorie les configurations du moniteur RTSP :

Tableau 3. Configuration du moniteur RTSP
Zone	Description
server	Système cible qui exécute le serveur de diffusion en flux. Par exemple, `rtsp.mymusic.com`.
remotefile	Fichier qui est téléchargé. Par exemple, `singalong.mp3`.
description	Zone de texte permettant d'indiquer des informations descriptives sur l'élément. Par exemple, `RTSP monitor`.
port	Port auquel se connecte le moniteur sur le système cible. Par défaut : 554
action	Action effectuée par le serveur sur le flot : DESCRIBE PLAY Par défaut : `DESCRIBE`
duration	Portion du flux, en secondes, exécutée par le serveur. La valeur par défaut est 5.
maxbandwidth	Bande passante maximale, n bits par seconde, utilisée pour le flot de données. Par défaut : 1500000
timeout	Durée d'attente d'une réponse du serveur RSTP, en secondes. Par défaut : 10
poll	Délai, en secondes, entre chaque interrogation. Par défaut : 300
failureretests	Nombre de nouvelles tentatives de test avant d'indiquer un échec. Par défaut : 0
retestinterval	Délai, en secondes, avant chaque nouveau test en cas d'incident. Par défaut : 10

Classifications de niveau de service

Les classifications des niveaux de services définissent les règles de détermination du niveau de service fourni via RTSP.

Les options de classification des niveaux de services disponibles pour le moniteur RTSP sont :

totalTime
lookupTime
connectTime
responseTime
sdpDownloadTime
playbackTime
status
percentPacketsLost
message

Dans les classifications des niveaux de services :

Spécifiez d'autres classifications des niveaux de services en entrant manuellement le nom de l'élément de moniteur. Ce nom doit correspondre à celui qui est indiqué pour l'élément dans la section des éléments Moniteurs.
message peut correspondre à n'importe quel message transmis via l'élément $message au IBM® Application Performance Management utilisé dans un widget. Pour obtenir une liste des valeurs possibles, voir Messages d'état.
L'opérande est une chaîne ou un nombre positif.
Le code d'état 200 indique la réussite. Voir le protocole RTSP pour les autres codes d'état renvoyés par l'opération.

Eléments du moniteur

Outre les résultats de test communs à tous les éléments, le moniteur RTSP génère un ensemble de résultats de test contenant les données propres aux tests de service RTSP.

Le tableau suivant décrit les éléments supplémentaires du moniteur RTSP.

Tableau 4. Eléments du moniteur RTSP
Elément	Description
$action	Action effectuée par le moniteur.
$averageBandwidth	Bande passante totale moyenne, en octets.
$bytesReceived	Nombre total d'octets reçus.
$connectTime* (`ConnectTime`)	Temps mis pour établir une connexion au serveur cible.
$describeStageStatus	Code d'état pour une étape de la conversation RTSP.
`$filename`	Nom du fichier multimédia.
$lookupTime* (`LookupTime`)	Temps mis pour obtenir l'adresse IP du serveur hôte.
$maxBandwidth	Bande passante maximale utilisant l'interface de configuration.
$mediaResponseTime	Durée nécessaire au serveur pour démarrer le flot de données du fichier requis.
$numberOfStreams	Nombre de flots imbriqués dans le média.
$percentPacketsLost	Pourcentage de paquets perdus.
$playbackTime* (`PlaybackTime`)	Durée qui représente la somme de `setupResponseTime` et de `mediaResponseTime`.
$playStageStatus	Code d'état pour une étape de la conversation RTSP.
$port	Port utilisé pour l'accès au serveur du moniteur.
$responseTime* (ResponseTime)	Durée entre l'établissement de la connexion et la réception du premier octet de données.
$sdpDownloadTime* (SdpDownloadTimed)	Durée nécessaire au téléchargement de données concernant le fichier multimédia.
$setupResponseTime	Durée qui représente une partie de `playbackTime`. Remarque : L'élément est généré uniquement lorsque le moniteur RTSP fonctionne en mode PLAY.
$setupStageStatus	Code d'état pour une étape de la conversation RTSP.
$status	Code d'état renvoyé par le serveur RTSP.
$streamingTime	Durée nécessaire au serveur pour terminer le flot de données du fichier requis.
$streamLength	Longueur du plus long flot du fichier multimédia.
$teardownStageStatus	Code d'état pour une étape de la conversation RTSP.
$totalBandwidthRequired	Bande passante totale, en kilooctets par seconde.
$totalPacketsLost	Nombre total de paquets perdus.
$totalPacketsReceived	Nombre de paquets reçus.

Messages d'état

Le moniteur RTSP fournit des messages d'état dans l'attribut ResultMessage lors de l'utilisation d'IBM Application Performance Management. Ces messages indiquent le résultat du test.

Tableau 5. Messages d'état du moniteur RTSP
Message	Description
`OK`	Demande effectuée.
`Connection failed`	Le moniteur n'a pas pu se connecter au serveur. Pour plus d'informations, consultez le fichier journal.
`Connection closed by foreign host`	La connexion au serveur RTSP a été interrompue.
`Timed out waiting to read/write`	Une connexion de données a été établie avec le serveur RTSP, mais un incident est apparu.
`Play failed - no streams`	Le moniteur a reçu une réponse, mais aucun élément audio ni vidéo n'était disponible pour la lecture.
`select() failed on RTSP socket (PLAY stage)`	Le socket a été fermé par le serveur distant, ou il a dépassé le délai en attendant une réponse.
`RTSP Server response not in expected format`	La réponse du serveur était dans un format que le moniteur ne prend pas en charge.
`Redirection requested by server not supported by client`	La réponse du serveur n'est pas prise en charge par le client.
`Server cannot fulfill client request`	La demande a échoué et aucune autre information n'est disponible.
`Server Error`	Un incident est apparu sur le serveur et la requête a échoué. Le code `500` ou supérieur a été renvoyé par le serveur. Pour plus d'informations, voir le protocole RTSP (RFC 2326).
`RTSP response header CSeq doesn't match request CSeq`	La configuration du serveur RTSP est incorrecte et ce dernier ne fonctionne pas correctement.
`Corrupted RTSP server response`
`Corrupted session description`
`RTSP SETUP response CSeq doesn't match request CSeq`
`RTSP SETUP response, incomplete Session string`
`RTSP SETUP response, Session ID has changed within the same session`
`RTSP SETUP response does not contain server ports to connect to`
`RTSP SETUP response does not contain server port pair to connect to`
`RTSP PLAY response CSeq doesn't match request CSeq`
`RTSP PLAY response, incomplete Session string`
`RTSP PLAY response, Session ID has changed within the same session`
`RTSP PLAY response, incomplete RTP-Info string`
`RTSP PLAY response does not valid RTP seqnum in RTP-Info response`
`RTSP PLAY response does not valid RTP time in RTP-Info response`