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.
Génération AWS Elemental MediaTailor journaux de débogage
Utilisez les journaux de débogage pour résoudre les problèmes de session de lecture liés à l'insertion d' MediaTailor annonces. Pour générer des journaux de débogage, configurez le mode de journalisation sur débogage à la demande du joueur. MediaTailor Pour les rapports côté serveur, définissez le mode journal dans la demande de lecture. Pour les rapports côté client, définissez le mode de journalisation dans la demande d'initialisation de session.
Lorsque le mode journal est défini sur débogage, MediaTailor écrit tous les types d'événements de journal dans CloudWatch Logs. Les journaux fournissent des informations sur les événements suivants. Pour une liste complète des données produites dans les journaux de débogage, voir Champs du journal de débogage.
-
Interaction d'origine : détails sur MediaTailor les interactions avec le serveur d'origine. Par exemple, la réponse du manifeste d'origine, le type de manifeste et l'URL d'origine.
-
Manifeste généré : détails sur la réponse à la session de lecture provenant de MediaTailor. Par exemple, le manifeste qui est MediaTailor généré.
-
Session initialisée : détails relatifs à l'initialisation de la session, tels que l'ID de session.
Pour personnaliser les types d'événements de journal que vous recevez par session, consultezFiltrage des journaux et des événements.
Conditions préalables
Pour configurer le mode journal sur débogage, vous devez d'abord MediaTailor autoriser l'envoi de journaux à CloudWatch, si ce n'est pas déjà fait. Une fois que vous avez accordé l'autorisation MediaTailor d'accès CloudWatch, vous êtes prêt à activer le mode journal de débogage. Pour plus d'informations sur la façon d'accorder MediaTailor l'autorisation d'accès, CloudWatch consultez Configuration des autorisations pour Amazon CloudWatch.
Comment configurer le mode journal pour le débogage
Cette section explique comment configurer le mode de journalisation pour le débogage pour les rapports côté serveur et les rapports côté client.
Server-side rapports
Pour les rapports côté serveur, incluez le paramètre et la valeur de la ?aws.logMode=DEBUG requête dans la demande de GET HTTP lecture de votre lecteur au point de terminaison HLS ou DASH. MediaTailor Pour des informations générales sur les rapports côté serveur, consultez la section Server-side Rapports.
Important
La valeur DEBUG est sensible à la casse.
Une demande de lecture qui inclut ?aws.logMode=DEBUG se présente comme suit :
Exemple Demande de lecture vers un point de terminaison HLS
GET <mediatailorURL>/v1/master/<hashed-account-id>/<origin-id>/<asset-id>?aws.logMode=DEBUGAprès avoir défini le mode de journalisation sur débogage, nous vous recommandons de vérifier que la session de journalisation du débogage est active. Pour vérifier que la session de débogage est active, vérifiez s'il existe des CloudWatch journaux pour l'ID de session. L'ID de session est inclus dans le point de terminaison de lecture MediaTailor fourni. Pour de plus amples informations, veuillez consulter Verify that the debug log mode is active for your playback session.
Client-side rapports
Pour les rapports côté client, incluez la logMode clé et la DEBUG valeur dans le corps de la demande d'initialisation de POST HTTP session de votre client au point de terminaison/. MediaTailor v1/session Pour des informations générales sur les rapports côté client, voir Client-Side Rapports.
Important
La valeur DEBUG est sensible à la casse.
Après avoir défini le mode de journalisation sur débogage, nous vous recommandons de vérifier que la session de débogage est active. Pour vérifier que la session de débogage est active, vérifiez qu'un SESSION_INITIALIZED événement est associé à l'ID de session dans les CloudWatch journaux. L'ID de session est inclus dans le point de terminaison de lecture MediaTailor fourni. Pour de plus amples informations, veuillez consulter Verify that the debug log mode is active for your playback session.
Nombre maximal de sessions de débogage actives
Vous pouvez avoir un maximum de 10 sessions de journal de débogage actives. Lorsque votre lecteur envoie sa demande d'initialisation de session ou de lecture à MediaTailor, MediaTailor vérifie si la limite a été atteinte. Si c'est le cas, MediaTailor vérifie s'il existe des sessions périmées. Une session est obsolète si elle n'a pas été consultée pendant un certain temps. Pour les diffusions en direct, cette durée est de 10 minutes, pour les diffusions en VOD, elle est de 30 minutes.
Si la limite maximale de sessions de journal de débogage actives a été atteinte, les journaux de débogage ne sont pas écrits dans CloudWatch les journaux de votre session. Si vous ne voyez pas les journaux de débogage dans CloudWatch les journaux de votre session, vous avez peut-être atteint cette limite. Pour vérifier si la limite a été atteinte, consultezVerify that the debug log mode is active for your playback session.
Champs du journal de débogage
Le tableau suivant répertorie les champs du journal de débogage dans lesquels vous MediaTailor écrivez. CloudWatch
| Champ | Description |
|---|---|
awsAccountId |
Votre Compte AWS carte d'identité. |
customerId |
Votre numéro de MediaTailor client. |
eventTimestamp |
Horodatage ISO 8601 associé à l'événement du journal de débogage. |
eventType |
Type d'événement du journal de débogage. Valeurs :
|
originRequestUrl |
URL de votre serveur d'origine qui est récupérée pour cette demande. |
mediaTailorPath |
Le MediaTailor point de terminaison qui a été appelé, y compris tous les paramètres transmis MediaTailor dans la demande de manifeste initiale. |
requestId |
L'ID d'une requête HTTP spécifique adressée à MediaTailor. |
responseBody |
Le manifeste dans le corps de la réponse provenant de MediaTailor. Il s'agit soit du manifeste d'origine brut, soit du manifeste généré par MediaTailor. |
sessionId |
L'ID de session de lecture. |
sessionType |
Type de session de lecture. Valeurs: |
Lire les journaux de débogage
MediaTailor écrit les journaux de débogage dans Amazon CloudWatch Logs. Des frais de CloudWatch journalisation typiques s'appliquent. Utilisez CloudWatch Insights pour lire les journaux de débogage. Pour plus d'informations sur l'utilisation de CloudWatch Logs Insights, consultez la section Analyse des données des CloudWatch journaux avec Logs Insights dans le guide de l'utilisateur d'AWS CloudWatch Logs.
Note
L'affichage des journaux de débogage peut prendre quelques minutes. CloudWatch Si vous ne voyez pas les journaux, patientez quelques minutes et réessayez. Si vous ne voyez toujours pas les journaux, il se peut que vous ayez atteint le nombre maximum de sessions de journal de débogage actives. Pour vérifier si c'est le cas, exécutez une CloudWatch requête pour voir si une session de débogage a été initialisée pour votre session de lecture. Pour de plus amples informations, veuillez consulter Verify that the debug log mode is active for your playback session.
Exemples
Cette section inclut des exemples de requêtes que vous pouvez utiliser pour lire les données du journal de MediaTailor débogage.
Exemple 1 : Vérifiez que le mode journal de débogage est actif pour votre session de lecture
fields @timestamp, @message | filter sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90" | 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
Exemple 2 : Afficher les réponses depuis votre origine
fields @timestamp, responseBody, @message, mediaTailorPath | filter eventType = "ORIGIN_MANIFEST" and sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"
Exemple 3 : Afficher le manifeste généré par MediaTailor pour une session donnée
fields @timestamp, responseBody, @message | filter mediaTailorPath like "/v1/master/" and eventType = "GENERATED_MANIFEST" and sessionId = "32002de2-837c-4e3e-9660-f3075e8dfd90"
Exemple 4 : Afficher tous les événements pour un ID de demande donné
Utilisez cette requête pour afficher le manifeste d'origine et le manifeste généré par MediaTailor.
fields @timestamp, responseBody, @message, mediaTailorPath | filter requestId = "e5ba82a5-f8ac-4efb-88a0-55bed21c45b4"
