View a markdown version of this page

Résoudre les problèmes de gestion et de suivi des sessions CDN pour MediaTailor - AWS Elemental MediaTailor

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Résoudre les problèmes de gestion et de suivi des sessions CDN pour MediaTailor

AWS Elemental MediaTailor la gestion des sessions du réseau de diffusion de contenu (CDN) est essentielle pour une personnalisation et un suivi appropriés des publicités. Si vous rencontrez des erreurs liées à la session ou si vous rencontrez un comportement incohérent entre les demandes :

  1. Vérifiez la cohérence de l'identifiant de session :

    • Vérifiez que votre lecteur conserve le même identifiant de session pour toutes les demandes relatives à une seule session de lecture

    • Vérifiez les journaux du CDN pour confirmer que la session IDs est correctement transférée

    • Assurez-vous que IDs les sessions sont correctement codées en URL dans les paramètres de requête

    • Utilisez CloudWatch les journaux pour vérifier la cohérence des identifiants de session entre les demandes (voir les étapes de validation ci-dessous)

  2. Validez l'initialisation de la session :

    • Vérifiez que la première demande de manifeste crée correctement une session

    • Vérifiez que le transfert des paramètres de session est correct (par exemple,aws.sessionId)

    • Vérifiez l'initialisation de la session à l'aide des journaux de débogage (voir la configuration des journaux de débogage ci-dessous)

  3. Activez la journalisation du débogage pour un dépannage détaillé des sessions :

    • Pour les rapports côté serveur : ajoutez ?aws.logMode=DEBUG à votre demande de lecture :

      GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/<asset-id>?aws.logMode=DEBUG

    • Pour les rapports côté client : incluez "logMode": "DEBUG" dans le corps de votre demande d'initialisation de session

    • Important : la DEBUG valeur distingue les majuscules et minuscules

    • Maximum de 10 sessions de débogage actives autorisées simultanément

  4. Utilisez CloudWatch les requêtes Logs pour valider le comportement des sessions :

    • Vérifiez que la session de débogage est active :

      fields @timestamp, @message
| filter sessionId = "your-session-id-here"
| filter eventType = "SESSION_INITIALIZED" # client-side reporting
or mediaTailorPath like "/v1/master" # server-side reporting HLS
or mediaTailorPath like "/v1/dash" # server-side reporting DASH

    • Afficher tous les événements d'une session :

      fields @timestamp, @message, eventType, mediaTailorPath
| filter sessionId = "your-session-id-here"
| sort @timestamp asc

    • Vérifiez la génération du manifeste pour une session :

      fields @timestamp, responseBody, @message
| filter mediaTailorPath like "/v1/master/" and eventType = "GENERATED_MANIFEST" and sessionId = "your-session-id-here"

  5. Tester le transfert des paramètres de session via le CDN :

    • Testez les demandes de manifeste avec des paramètres de session directement par rapport MediaTailor (en contournant le CDN)

    • Comparez le comportement des sessions avec et sans CDN pour identifier les problèmes de transfert

    • Vérifiez que la configuration de transfert des paramètres de requête CDN inclut les paramètres liés à la session

    • Vérifiez que le CDN ne met pas en cache les réponses qui devraient être spécifiques à la session

Messages d'erreur de session courants :

  • ConflictException(HTTP 409) - Plusieurs demandes de playlist simultanées pour la même session. Solution : assurez-vous que votre joueur demande les playlists une par une conformément aux spécifications HLS

  • NotFoundException(HTTP 404) - La session n'est pas disponible ou la configuration n'existe pas. Solution : Vérifiez la validité de votre configuration et réinitialisez la session

  • BadRequestException(HTTP 400) - ID de session non valide ou demande mal formatée. Solution : vérifier le format des demandes et la validité de l'identifiant de session

Ressources de résolution des problèmes supplémentaires :

Critères de réussite : une fois résolues, les sessions doivent s'initialiser correctement, maintenir une session IDs cohérente entre les demandes, et les journaux de débogage doivent indiquer les SESSION_INITIALIZED événements appropriés et la génération de manifestes sans erreur.