Un TraceID RTS est un identifiant de requête globalement unique utilisé pour le suivi et le dépannage des problèmes. Il est essentiel pour résoudre efficacement les problèmes d'intégration et de lecture rencontrés par les clients. Cette rubrique explique comment obtenir un TraceID RTS.
Contexte
Le dépannage des problèmes de lecture en s'appuyant sur des détails tels que l'adresse IP de l'utilisateur et l'heure de lecture peut s'avérer inefficace. Cette méthode nécessite de parcourir d'importants volumes de journaux pour trouver les entrées pertinentes, une tâche qui devient encore plus ardue lorsque le même utilisateur lance plusieurs sessions de lecture sur une courte période. Real-Time Streaming (RTS) génère un TraceID pour chaque tentative de lecture. Cet identifiant globalement unique permet à Alibaba Cloud de localiser rapidement la session spécifique associée à un problème. Nous vous recommandons vivement de corréler ce TraceID avec vos propres journaux client.
Vous pouvez obtenir un TraceID RTS de différentes manières :
Obtenir un TraceID à partir d'un lecteur de démonstration
Démo client mobile (Android/iOS)
Pour obtenir des instructions sur la lecture d'un flux avec la démo mobile, consultez le Tutoriel de démonstration. Une fois que le lecteur est connecté au flux, cliquez sur Troubleshoot sur l'écran du lecteur. Le RequestId affiché dans la fenêtre contextuelle correspond au TraceID.
La fenêtre contextuelle affiche le RequestId et l'URL de streaming. Cliquez sur Copy en bas pour copier ces informations, que vous pourrez ensuite soumettre dans un ticket de support pour le dépannage.
Démo client Web (H5)
Pour obtenir des instructions sur la lecture d'un flux avec la démo Web, consultez le Tutoriel de démonstration. Une fois que le lecteur est connecté au flux, cliquez sur Troubleshoot sur la page du lecteur Web RTS pour afficher le TraceID dans la fenêtre contextuelle.
La fenêtre contextuelle contient les champs URL et TraceID. Cliquez sur le bouton Copy en bas à droite pour copier ces informations, que vous pourrez ensuite soumettre dans un ticket de support pour le dépannage.
Obtenir un TraceID dans un environnement de production
Un environnement de production fait référence à votre propre application intégrant le SDK, par opposition aux démos d'Alibaba Cloud.
Environnement de production client mobile (Android/iOS)
Utilisez un rappel d'événement du SDK ApsaraVideo Player pour obtenir le TraceID.
Un TraceID unique est généré pour chaque session de lecture à faible latence et peut être utilisé pour le dépannage des problèmes.
-
Android
// Listen for the onInfo callback from the player and parse the DemuxerTraceID message. mRtsAliPlayer.setOnInfoListener(infoBean -> { if (infoBean.getCode() == InfoCode.DemuxerTraceID) { String traceId = infoBean.getExtraMsg(); }); -
iOS
// Listen for the onPlayerEvent callback from the player and parse the DemuxerTraceID message. - (void)onPlayerEvent:(AliPlayer*)player eventWithString:(AVPEventWithString)eventWithString description:(NSString *)description { switch (eventWithString) { case EVENT_PLAYER_DEMUXER_TRACE_ID: { NSString *traceId = description; } break; default: break; } }
Environnement de production client Web (H5)
-
Obtenir le TraceID à partir de la réponse à la requête de signalisation
Une requête de signalisation pour un client Web est une requête HTTP POST. Vous pouvez trouver le TraceID en utilisant l'onglet Network Type dans les outils de développement de votre navigateur. Par exemple, si l'URL de streaming est
artc://player.alicdn.com/a/b_RTS, la requête de signalisation correspondante esthttp(s)://player.alicdn.com/a/b_RTS.Accédez au lecteur RTS pour le Web.
Sur la page du lecteur RTS pour le Web, saisissez une URL de streaming pour un flux compatible RTS. Par exemple :
artc://player.alicdn.com/a/b_RTS.Cliquez sur Start Streaming pour lire le flux RTS.
Appuyez sur F12 pour ouvrir les outils de développement de votre navigateur, puis sélectionnez l'onglet Network.
Recherchez la requête de signalisation,
http(s)://player.alicdn.com/a/b_RTS, et trouvez le TraceID dans la section Response.
-
SDK ApsaraVideo Player pour le Web
Le SDK ApsaraVideo Player pour le Web vous permet d'obtenir le TraceID RTS en vous abonnant à l'événement
rtsTraceId. Le code suivant illustre cette procédure :// This event triggers when an RTS stream is pulled. The event data contains the traceId (the stream's TraceID) and the source (the streaming URL). player.on('rtsTraceId', function(event) { console.log('EVENT rtsTraceId', event.paramData); })