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. # Surveillance avec analyse de la qualité du contenu dans AWS Elemental MediaConnect Vous pouvez utiliser l'analyse de la qualité MediaConnect du contenu pour surveiller vos flux sources de manière plus efficace. Cette fonctionnalité vous permet de suivre des indicateurs audio et vidéo spécifiques, ce qui vous permet de vous assurer que votre contenu répond aux normes de qualité requises. En surveillant ces indicateurs, vous pouvez rapidement identifier les anomalies dans vos flux, ce qui vous permet de résoudre rapidement les problèmes et de maintenir la qualité du contenu. Lorsqu'elle est utilisée conjointement avec d'autres outils de MediaConnect surveillance, l'analyse de la qualité du contenu vous fournit une vue complète de la qualité de votre stream. Cette approche de surveillance intégrée vous permet de mettre en œuvre des mesures proactives et de garantir un flux de diffusion multimédia fluide et fiable. **Table des matières** + [Points clés](#monitor-content-quality-analysis-key-points) + [Comment fonctionne l'analyse de la qualité du contenu](#how-content-quality-analysis-works) + [Considérations](#content-quality-analysis-considerations) + [Étapes suivantes](#content-quality-analysis-next-steps) ## Points clés ### Comment fonctionne l'analyse de la qualité du contenu Vous pouvez surveiller les problèmes de qualité du contenu suivants : + **Périodes audio silencieuses :** utilisez cette métrique pour détecter les périodes de silence audio dans le flux. Cela est utile pour détecter des microphones désactivés lors d'émissions en direct, des silences involontaires lors d'enregistrements ou des problèmes d'encodage audio. + **Images noires :** utilisez cette métrique pour détecter les périodes d'images vidéo noires dans le flux. Cela est utile pour identifier les problèmes liés aux diffusions en direct, au contenu préenregistré ou à votre processus d'encodage vidéo. + **Images figées :** utilisez cette métrique pour détecter les périodes pendant lesquelles les images vidéo ne changent pas dans le flux. Cela est utile pour les événements en direct, pour identifier les problèmes d'équipement ou pour détecter les problèmes liés à la diffusion de votre contenu. Pour chaque métrique, vous pouvez définir des seuils de durée personnalisés afin de déterminer avec précision le moment où les alertes sont déclenchées en fonction de vos besoins spécifiques. MediaConnect surveille ensuite l'état du contenu de votre flux source, en publiant des avertissements et des alertes lorsque des problèmes surviennent dans les zones que vous avez choisi de surveiller. ### Considérations + L'analyse de la qualité du contenu ne fonctionne qu'avec les flux sources des flux de transport. Les flux CDI et les flux relais ne sont actuellement pas pris en charge. + La fonction d'analyse de la qualité du contenu surveille uniquement le premier flux vidéo et le premier flux audio qu'il rencontre au sein d'une même source. + La surveillance de l'analyse de la qualité du contenu est limitée aux flux comportant 10 sorties ou moins. Si un flux dépasse 10 sorties, l'analyse du contenu de ce flux est MediaConnect automatiquement désactivée. + Cette fonctionnalité est disponible sans frais supplémentaires partout Régions AWS où elle MediaConnect est disponible. ## Étapes suivantes Pour commencer à utiliser cette fonctionnalité, consultez[Permettre l'analyse de la qualité du contenu et configurer les seuils](enable-content-quality-analysis.md). # Permettre l'analyse de la qualité du contenu et configurer les seuils Vous activez l'analyse de la qualité du contenu pour chaque flux de manière MediaConnect individuelle. Vous pouvez le faire lorsque vous créez un nouveau flux ou lorsque vous mettez à jour un flux existant. Pour chaque flux, vous pouvez personnaliser l'expérience de surveillance en configurant des seuils pour des métriques individuelles ou en désactivant des métriques spécifiques selon les besoins. Cette page vous guide tout au long du processus d'activation de l'analyse de la qualité du contenu et de configuration de ses indicateurs. ## Conditions préalables Si vous souhaitez activer l'analyse de la qualité du contenu pour un flux existant, assurez-vous que l'état du flux est `STANDBY``UPDATING`, ou `ACTIVE` avant de commencer. ## Procédure Vous pouvez activer l'analyse de la qualité du contenu via l'AWS Management Console, la CLI AWS et l' MediaConnect API. ### Activation de l'analyse de la qualité du contenu lors de la création d'un flux ------ #### [ Console ] **Pour activer l'analyse de la qualité du contenu lorsque vous créez un flux** Suivez les instructions ci-dessous pour [Création d’un flux](flows-create.md). À l'étape de **configuration de la surveillance de la source**, assurez-vous d'activer l'**état d'analyse de la qualité du contenu.** Lorsque vous activez l'analyse de la qualité du contenu, vous pouvez définir un seuil pour les mesures suivantes. Pour chaque métrique, vous pouvez saisir une valeur comprise entre 10 et 60 secondes. Le seuil par défaut est de 30 secondes. **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/mediaconnect/latest/ug/enable-content-quality-analysis.html) ------ #### [ AWS CLI ] **Pour activer l'analyse de la qualité du contenu avec les paramètres par défaut** Exécutez la commande [create-flow](https://docs.aws.amazon.com/cli/latest/reference/mediaconnect/create-flow.html) comme indiqué dans l'exemple suivant : ``` aws mediaconnect create-flow --flow-name "myFlow" \ --source-arn "sourceFlowARN" \ --source-monitoring-config ContentQualityAnalysisState=ENABLED \ --other-required-parameters ``` MediaConnect active automatiquement toutes les mesures individuelles avec une valeur par défaut de 30 secondes, comme indiqué ci-dessous : ``` { "Flow": { "FlowArn": , ... "SourceMonitoringConfig": { "ContentQualityAnalysisState": "ENABLED", "AudioMonitoringSettings": [ { "SilentAudio": { "State": "ENABLED", "ThresholdSeconds": 30 } } ], "VideoMonitoringSettings": [ { "BlackFrames": { "State": "ENABLED", "ThresholdSeconds": 30 }, "FrozenFrames": { "State": "ENABLED", "ThresholdSeconds": 30 } } ] } } } ``` **Pour permettre l'analyse de la qualité du contenu avec des seuils personnalisés** Exécutez la commande [create-flow](https://docs.aws.amazon.com/cli/latest/reference/mediaconnect/create-flow.html) avec le `--source-monitoring-config` paramètre configuré comme indiqué ci-dessous. L'exemple de commande suivant active les trois métriques avec des seuils personnalisés : ``` aws mediaconnect create-flow --flow-name "myFlow" \ --source-arn "sourceFlowARN" \ --source-monitoring-config '{"ContentQualityAnalysisState": "ENABLED", \ "VideoMonitoringSettings": [{ \ "FrozenFrames": {"State": "ENABLED", "ThresholdSeconds": }, \ "BlackFrames": {"State": "ENABLED", "ThresholdSeconds": }}], \ "AudioMonitoringSettings": [{ \ "SilentAudio": {"State": "ENABLED", "ThresholdSeconds": }}]}' ``` Gardez à l’esprit les points suivants : + Pour chaque seuil, remplacez-le ** par une valeur comprise entre 10 et 60 secondes. + Si vous ne spécifiez aucun seuil, la valeur par défaut de 30 secondes est utilisée. + Vous pouvez activer une ou plusieurs des mesures suivantes. + Si vous activez la surveillance vidéo, vous devez activer au moins l'une `BlackFrames` des `FrozenFrames` métriques. + Si vous activez la surveillance audio, vous devez activer la `SilentAudio` métrique. **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/mediaconnect/latest/ug/enable-content-quality-analysis.html) ------ ### Activation de l'analyse de la qualité du contenu dans un flux existant ------ #### [ Console ] **Pour activer l'analyse de la qualité du contenu dans un flux existant** Suivez les instructions ci-dessous pour [Mise à jour d’un flux](flows-update.md). À l'étape de **configuration de la surveillance de la source**, assurez-vous d'activer l'**état d'analyse de la qualité du contenu.** Lorsque vous activez l'analyse de la qualité du contenu, vous pouvez définir un seuil pour les mesures suivantes. Pour chaque métrique, vous pouvez saisir une valeur comprise entre 10 et 60 secondes. Le seuil par défaut est de 30 secondes. **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/mediaconnect/latest/ug/enable-content-quality-analysis.html) ------ #### [ AWS CLI ] **Pour activer l'analyse de la qualité du contenu avec les paramètres par défaut** Exécutez la commande [update-flow](https://docs.aws.amazon.com/cli/latest/reference/mediaconnect/update-flow.html) comme indiqué dans l'exemple suivant : ``` aws mediaconnect update-flow --flow-arn "FlowArn" \ --source-monitoring-config ContentQualityAnalysisState=ENABLED ``` MediaConnect active automatiquement toutes les mesures individuelles avec une valeur par défaut de 30 secondes, comme indiqué ci-dessous : ``` { "Flow": { "FlowArn": , ... "SourceMonitoringConfig": { "ContentQualityAnalysisState": "ENABLED", "AudioMonitoringSettings": [ { "SilentAudio": { "State": "ENABLED", "ThresholdSeconds": 30 } } ], "VideoMonitoringSettings": [ { "BlackFrames": { "State": "ENABLED", "ThresholdSeconds": 30 }, "FrozenFrames": { "State": "ENABLED", "ThresholdSeconds": 30 } } ] } } } ``` **Pour permettre l'analyse de la qualité du contenu avec des seuils personnalisés** Exécutez la commande [update-flow](https://docs.aws.amazon.com/cli/latest/reference/mediaconnect/update-flow.html) avec le `--source-monitoring-config` paramètre configuré comme indiqué ci-dessous. Cet exemple de commande active les trois métriques avec des seuils personnalisés. ``` aws mediaconnect update-flow \ --flow-arn "FlowArn" \ --source-monitoring-config '{"ContentQualityAnalysisState": "ENABLED", \ "VideoMonitoringSettings": [{ \ "FrozenFrames": {"State": "ENABLED", "ThresholdSeconds": }, \ "BlackFrames": {"State": "ENABLED", "ThresholdSeconds": }}], \ "AudioMonitoringSettings": [{ "SilentAudio": {"State": "ENABLED", "ThresholdSeconds": }}]}' \ ``` Gardez à l’esprit les points suivants : + Pour chaque seuil, remplacez-le ** par une valeur comprise entre 10 et 60 secondes. + Si vous activez une métrique pour la première fois et que vous ne spécifiez pas de seuil, la valeur par défaut de 30 secondes est utilisée. + Si vous mettez à jour une métrique précédemment activée et que vous ne spécifiez pas de seuil, la valeur précédemment définie est conservée. + Vous pouvez activer une ou plusieurs des mesures suivantes. + Si vous activez la surveillance vidéo, vous devez activer au moins l'une `BlackFrames` des `FrozenFrames` métriques. + Si vous activez la surveillance audio, vous devez activer la `SilentAudio` métrique. **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/mediaconnect/latest/ug/enable-content-quality-analysis.html) ------ ## Étapes suivantes + Après avoir activé l'analyse de la qualité du contenu pour un flux, MediaConnect commence à analyser le flux source et à signaler tout problème détecté. Pour obtenir des instructions sur la manière de résoudre ces problèmes, consultez[Affichage des paramètres d'analyse de la qualité du contenu et des alertes](content-quality-analysis-viewing.md). + Si vous ne souhaitez plus analyser la qualité du contenu de votre flux, vous pouvez désactiver cette fonctionnalité. Pour obtenir des instructions, veuillez consulter [Désactivation de l'analyse de la qualité du contenu](disable-content-quality-analysis.md). ## Ressources supplémentaires + [Création d’un flux](flows-create.md) + [Mise à jour d’un flux](flows-update.md) + [Surveillance et balisage dans AWS Elemental MediaConnect](monitor.md) # Affichage des paramètres d'analyse de la qualité du contenu et des alertes Lorsque vous activez l'analyse de la qualité du contenu, vous commencez MediaConnect à publier des avertissements et des alertes pour les métriques activées dans votre compte AWS. Cette page vous guide tout au long du processus de confirmation de vos paramètres d'analyse de la qualité du contenu et de visualisation des avertissements et alertes relatifs aux flux de votre compte. ## Conditions préalables La procédure suivante suppose que vous avez déjà activé l'analyse de la qualité du contenu pour un flux. ## Procédure Vous pouvez consulter les avertissements et alertes relatifs à la qualité du contenu par le biais de l'AWS Management Console, de l'AWS CLI et de l' MediaConnect API. ------ #### [ Console ] **Pour vérifier si l'analyse de la qualité du contenu est activée** 1. Ouvrez la MediaConnect console à l'adresse [https://console.aws.amazon.com/mediaconnect/](https://console.aws.amazon.com/mediaconnect/). 1. Dans l'écran **Flux**, sélectionnez le flux que vous souhaitez inspecter. 1. Sur la page des détails du flux, choisissez l'onglet **Configuration**. 1. Sous **Configuration de la surveillance de la source**, vous pouvez trouver l'état de l'analyse de la qualité du contenu. ![\[Un MediaConnect flux dans lequel l'analyse de la qualité du contenu est activée.\]](http://docs.aws.amazon.com/fr_fr/mediaconnect/latest/ug/images/content-quality-analysis-enabled.png) **Pour vérifier si des alertes de qualité sont présentes** 1. Ouvrez la MediaConnect console à l'adresse [https://console.aws.amazon.com/mediaconnect/](https://console.aws.amazon.com/mediaconnect/). 1. Dans l'écran **Flux**, sélectionnez le flux que vous souhaitez inspecter. 1. Dans l'onglet **Alertes**, des alertes apparaissent lorsque des problèmes de qualité du contenu sont détectés dans la source du flux. ![\[Une alerte de qualité du contenu affichée sur la page de détails MediaConnect d'un flux.\]](http://docs.aws.amazon.com/fr_fr/mediaconnect/latest/ug/images/content-quality-analysis-alert.png) ------ #### [ AWS CLI ] Pour vérifier si les métriques d'analyse de qualité sont activées pour un flux donné, exécutez la commande [describe-flow](https://docs.aws.amazon.com/cli/latest/reference/mediaconnect/describe-flow.html) : ``` aws mediaconnect describe-flow --flow-arn flowARN ``` La réponse indique quelles mesures d'analyse de la qualité du contenu sont activées : ``` { "Flow": { "FlowArn": "flowARN", ... "SourceMonitoringConfig": { "ContentQualityAnalysisState": "ENABLED", "AudioMonitoringSettings": [ { "SilentAudio": { "State": "DISABLED", "ThresholdSeconds": 15 } } ], "VideoMonitoringSettings": [ { "BlackFrames": { "State": "DISABLED", "ThresholdSeconds": 10 }, "FrozenFrames": { "State": "ENABLED", "ThresholdSeconds": 5 } } ] }, ... } } ``` La réponse affiche également des messages concernant les avertissements ou alertes qui nécessitent votre attention : ``` { ... "Messages": { "Errors": [ "Monitoring Stream Alert: Audio Stream Missing. Please investigate the flow source.", "Monitoring Stream Alert: Video Stream Missing. Please investigate the flow source." ] } } ``` Sinon, si des flux audio et vidéo sont présents mais que vous rencontrez des problèmes, vous pourriez voir quelque chose comme ceci : ``` { ... "Messages": { "Errors": [ "Monitoring Stream Alert: Black frames detected for more than 30 seconds. Please investigate the flow source.", "Monitoring Stream Alert: Frozen frames detected for more than 30 seconds. Please investigate the flow source.", "Monitoring Stream Alert: Silent audio detected for more than 30 seconds. Please investigate the flow source." ] } ``` **Note** Ces messages d'erreur dépendent du contexte. Si un flux audio ou vidéo est absent, les alertes de qualité associées à ce flux (telles que le son silencieux ou les black/frozen images) ne seront pas déclenchées. ------ ## Étapes suivantes Si vous ne souhaitez plus analyser la qualité du contenu de votre flux, vous pouvez désactiver cette fonctionnalité. Pour obtenir des instructions, veuillez consulter [Désactivation de l'analyse de la qualité du contenu](disable-content-quality-analysis.md). # Désactivation de l'analyse de la qualité du contenu Vous pouvez désactiver la fonctionnalité d'analyse de la qualité du contenu sans perdre les paramètres précédemment configurés pour les mesures individuelles. Si vous réactivez l'analyse de la qualité du contenu à l'avenir, vos seuils personnalisés pour les indicateurs individuels sont préservés afin que vous n'ayez pas à les reconfigurer. Cette page vous guide tout au long du processus de désactivation de la fonctionnalité d'analyse de la qualité du contenu. ## Conditions préalables La procédure suivante suppose que vous avez déjà activé l'analyse de la qualité du contenu pour un flux. Vous pouvez désactiver l'analyse de la qualité du contenu sur un flux actif ou inactif. Si le flux est actif, il n'est pas nécessaire de l'arrêter au préalable. ## Procédure Vous pouvez désactiver l'analyse de la qualité du contenu via la console de gestion AWS, l'interface de ligne de commande AWS et l' MediaConnect API. ------ #### [ Console ] **Pour désactiver l'analyse de la qualité du contenu** 1. Ouvrez la MediaConnect console à l'adresse [https://console.aws.amazon.com/mediaconnect/](https://console.aws.amazon.com/mediaconnect/). 1. Dans l'écran **Flux**, sélectionnez le flux pour lequel vous souhaitez désactiver l'analyse de la qualité du contenu. 1. Sur la page des détails du flux, choisissez l'onglet **Sources**. 1. Dans la section **Configuration de la surveillance de la source**, choisissez **Modifier**. 1. Choisissez l’une des options suivantes : 1. Pour désactiver toutes les mesures, désactivez l'**état d'analyse de la qualité du contenu**. 1. Pour désactiver des métriques spécifiques, désactivez une ou plusieurs des métriques suivantes : **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/mediaconnect/latest/ug/disable-content-quality-analysis.html) 1. Choisissez **Mettre à jour** pour enregistrer vos modifications. ------ #### [ AWS CLI ] **Pour désactiver toutes les métriques** Exécutez la commande [update-flow](https://docs.aws.amazon.com/cli/latest/reference/mediaconnect/update-flow.html) comme indiqué dans l'exemple suivant : ``` aws mediaconnect update-flow \ --flow-arn "flowARN" \ --source-monitoring-config ContentQualityAnalysisState=DISABLED ``` Dans l'exemple de réponse suivant, elle `ContentQualityAnalysisState` est désormais désactivée, mais les paramètres de mesure individuels restent inchangés : ``` { "Flow": { "FlowArn": "", ... "SourceMonitoringConfig": { "ContentQualityAnalysisState": "DISABLED", "ThumbnailState": "ENABLED", "AudioMonitoringSettings": [ { "SilentAudio": { "State": "ENABLED", "ThresholdSeconds": 30 } } ], "VideoMonitoringSettings": [ { "BlackFrames": { "State": "ENABLED", "ThresholdSeconds": 30 }, "FrozenFrames": { "State": "ENABLED", "ThresholdSeconds": 10 } } ] } } } ``` **Note** Lorsqu'il `ContentQualityAnalysisState` est défini sur`DISABLED`, il a priorité sur les paramètres de mesure individuels. Cela signifie que même si les indicateurs individuels (`SilentAudio`,`BlackFrames`,`FrozenFrames`) apparaissent comme tels`ENABLED`, ils ne sont pas actifs. Cela vous permet de conserver votre configuration préférée pour les métriques individuelles sans avoir à les reconfigurer à chaque fois que vous basculez sur l'ensemble. `ContentQualityAnalysisState` Lorsque vous souhaitez réactiver l'analyse de la qualité du contenu, `ContentQualityAnalysisState` revenez à`ENABLED`. Vos paramètres de mesure individuels précédemment configurés redeviendront alors actifs. **Pour désactiver des métriques spécifiques** Exécutez la commande [update-flow](https://docs.aws.amazon.com/cli/latest/reference/mediaconnect/update-flow.html) avec le paramètre `--source-monitoring-config parameter` configuré comme indiqué ci-dessous. L'exemple de commande suivant désactive les deux mesures de surveillance vidéo tout en préservant les seuils personnalisés pour une utilisation future : ``` aws mediaconnect update-flow \ --flow-arn "FlowArn" \ --source-monitoring-config ContentQualityAnalysisState=ENABLED \ '{"VideoMonitoringSettings": [ \ {"FrozenFrames": {"State": "DISABLED", "ThresholdSeconds": 10}}, \ {"BlackFrames": {"State": "DISABLED", "ThresholdSeconds": 15}}], \ "AudioMonitoringSettings": [ \ {"SilentAudio": {"State": "ENABLED", "ThresholdSeconds": 25}}]}' ``` Dans l'exemple de réponse suivant, `ContentQualityAnalysisState` reste activé, mais les deux mesures de surveillance vidéo sont désormais désactivées : ``` { "Flow": { "FlowArn": , ... "SourceMonitoringConfig": { "ContentQualityAnalysisState": "ENABLED", "AudioMonitoringSettings": [ { "SilentAudio": { "State": "ENABLED", "ThresholdSeconds": 25 } } ], "VideoMonitoringSettings": [ { "BlackFrames": { "State": "DISABLED", "ThresholdSeconds": 15 }, "FrozenFrames": { "State": "DISABLED", "ThresholdSeconds": 10 } } ] } } } ``` Gardez à l’esprit les points suivants : + Il n'est pas nécessaire de modifier ou de supprimer les seuils existants pour les mesures individuelles. Si vous réactivez l'analyse de la qualité du contenu à l'avenir, vos seuils personnalisés sont préservés afin que vous n'ayez pas à les reconfigurer. + Vous pouvez désactiver une, deux ou les trois mesures suivantes : **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/mediaconnect/latest/ug/disable-content-quality-analysis.html) ------ ## Étapes suivantes Vous pouvez réactiver la fonctionnalité d'analyse de la qualité du contenu à tout moment. Pour obtenir des instructions, veuillez consulter [Activation de l'analyse de la qualité du contenu dans un flux existant](enable-content-quality-analysis.md#enable-content-quality-analysis-procedure-existing-flow).