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 d'une chaîne à l'aide d'Amazon CloudWatch Logs
MediaLive produit des journaux de chaînes qui contiennent des informations détaillées sur l'activité d'une chaîne. Les journaux fournissent une description séquentielle de l'activité qui se produit dans le canal. Ces journaux peuvent être utiles lorsque les informations contenues dans les alertes ([Surveillance d'un canal ou d'un multiplex à l'aide d'Amazon CloudWatch Events](monitoring-via-cloudwatch.md)) ne sont pas suffisantes pour résoudre un problème sur le canal.
**Topics**
+ [À propos des journaux de chaînes](monitoring-logs-about.md)
+ [Activation des journaux des encodeurs de canaux](enabling-disabling-logs.md)
+ [Utilisation des journaux](working-with-logs.md)
# À propos des journaux de chaînes
MediaLive produit des journaux de chaînes qui contiennent des informations détaillées sur l'activité d'une chaîne. Les journaux fournissent une description séquentielle de l'activité qui se produit dans le canal. Ces journaux peuvent être utiles lorsque les informations contenues dans les alertes ([Surveillance d'un canal ou d'un multiplex à l'aide d'Amazon CloudWatch Events](monitoring-via-cloudwatch.md)) ne sont pas suffisantes pour résoudre un problème sur le canal.
Il existe deux ensembles de journaux de chaînes :
+ Journaux des encodeurs de canaux. Vous devez [activer](enabling-disabling-logs.md) ces journaux.
+ Journaux de diffusion des canaux. MediaLive produit toujours ces journaux.
## Comparaison des types de journaux
**Fonctionnalités identiques dans les deux types de journaux**
Les deux types de journaux sont envoyés à Amazon CloudWatch Logs. Vous pouvez utiliser les fonctionnalités standard des CloudWatch journaux pour afficher et gérer les journaux. Pour plus d'informations, consultez le [guide de l'utilisateur d'Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html).
**Caractéristiques différentes dans les deux types de journaux**
Le tableau suivant décrit les différences entre les journaux de l'encodeur de canal et les journaux des canaux au fur et à mesure de l'exécution.
| | Journaux de l'encodeur | Journaux au fur et à mesure |
| --- | --- | --- |
| Déclencheur pour la création | Vous devez [activer ces journaux](enabling-disabling-logs.md) pour MediaLive pouvoir les produire. | MediaLive produit toujours ces journaux. |
| Niveau de détail | Vous pouvez définir un niveau de journalisation pour contrôler les détails collectés. | Vous ne pouvez pas modifier le niveau de journalisation. |
| Cost | Ces journaux sont payants, dans le cadre de vos frais pour Amazon CloudWatch Logs. Consultez les [ CloudWatch tarifs d'Amazon](https://aws.amazon.com/cloudwatch/pricing/). N'oubliez pas [de supprimer les journaux](working-with-logs.md#manage-log-storage) après avoir supprimé la chaîne. | Ces journaux sont gratuits. |
| CloudWatch flux de log | Le flux de journaux est nommé d'après l'ARN/le pipeline. | Le flux de log est nommé d'après le ARN/pipeline mot « with \$1as\$1run » ajouté au nom. |
| Automatisation | Vous ne devez automatiser aucun traitement sur la base du libellé de ces journaux, car ce libellé est sujet à modification.(En comparaison, vous pouvez automatiser en fonction du libellé des alertes, auxquelles vous pouvez accéder via CloudWatch Events, car le libellé des alertes ne change pas.) | Vous pouvez automatiser en fonction du libellé de ces journaux. |
# Activation des journaux des encodeurs de canaux
Vous activez les journaux des encodeurs de canal pour un canal individuel sur la MediaLive console. Vous activez la journalisation et vous définissez le niveau de journalisation (erreur, avertissement, information ou débogage) pour un canal. Pour que vous puissiez activer ou désactiver la journalisation le canal doit être inactif.
Il n'est pas nécessaire d'activer les journaux au fur et à mesure de l'exécution. MediaLive produit toujours ces journaux.
**Pour activer le journal d'un encodeur de canal (MediaLive console)**
1. Si vous êtes un utilisateur récurrent de MediaLive, vérifiez auprès de votre administrateur que votre déploiement a été configuré dans AWS IAM pour prendre en charge les journaux des chaînes.
1. Votre administrateur peut vous demander de mettre à jour l'autorisation `MediaLiveAccessRole` dans l'un des canaux. Si vous recevez cette instruction, vous devez [modifier un canal](editing-deleting-channel.md#editing-a-channel) (choisissez n'importe quel canal inactif), [afficher la page **Channel and input details (Détails du canal et de l'entrée)**](role-and-remember-arn.md), puis choisir le bouton **Update (Mettre à jour)**. Lorsque le rôle est mis à jour dans un canal, la modification s'applique à tous les canaux.
1. Pour activer les journaux de l'encodeur dans un nouveau canal, configurez la journalisation lors de [la création](creating-channel-scratch.md).
Pour activer les journaux de l'encodeur dans un canal existant, [modifiez le canal](editing-deleting-channel.md#editing-a-channel) ; ce canal doit être inactif.
Dans les deux cas, sur la page **General settings (Paramètres généraux)**, dans la section **Channel logging (Journalisation de canal)**, choisissez **Logging (Journalisation)**. Choisissez un niveau autre que **DISABLED (DÉSACTIVÉ)**. Pour de plus amples informations, veuillez consulter [Logging](creating-a-channel-step3.md#channel-logging).
1. Vous ou un administrateur pouvez également accéder aux CloudWatch journaux et définir une date d'expiration pour les journaux.
## Désactivation des journaux des encodeurs de canaux
Vous désactivez la capture des informations de journalisation relatives à l'encodeur pour un canal individuel sur la MediaLive console. Modifiez le canal, puis, sur la page **General settings (Paramètres généraux)**, dans la section **Channel logging (Journalisation de canal)**, choisissez **Logging (Journalisation)**. Définissez le niveau sur **DISABLED (DÉSACTIVÉ)**.
# Utilisation des journaux
Vous pouvez consulter à la fois les journaux de l'encodeur et les journaux d'exécution sur la console CloudWatch Logs, de la même manière que vous consultez les journaux de n'importe quel service.
Il n'est pas nécessaire de configurer les journaux, les groupes de journalisation ou les flux de CloudWatch journaux sur la console Logs, car ils les configurent MediaLive automatiquement pour vous.
+ Groupe de journaux — Le groupe de journaux est toujours le suivant : **ElementalMediaLive**.
+ Flux de journal : le flux de journal est nommé comme suit :
+ Journaux de l'encodeur : nommés d'après l'ARN/Pipeline.
+ Journaux exécutés : nommés d'après le ARN/pipeline nom auquel est `_as_run` ajouté.
Par exemple :
`arn_aws_medialive_us-west-2_111122223333_channel_5106412_0`
`arn_aws_medialive_us-west-2_111122223333_channel_5106412_0_as_run`
Où `5106412` se trouvent l'identifiant du canal et `0` le pipeline.
## Contenu des journaux de l'encodeur
Les journaux sont au format JSON :
```
{
"encoder_pipeline": 0,
"severity": "I",
"timestamp": "2018-05-21T16:36:41.650318",
"channel_arn": "arn:aws:medialive:us-west-2:111122223333:channel:5106412",
"logger_name": "",
"message": "Probing input media..."
},
.
.
.
]
```
Les données sont les suivantes :
+ `encoder_pipeline` : `0` ou `1` (si le canal est configuré en tant que [canal standard](channel-class.md) et, par conséquent, possède deux pipelines).
+ `severity` : une lettre. Le niveau de journalisation (que vous définissez lorsque vous activez la journalisation) contrôle les niveaux de gravité qui peuvent apparaître dans les journaux. Pour de plus amples informations, veuillez consulter [Niveaux de journalisation et détails](#log-levels).
+ `timestamp` : heure au format ISO 8601 : aaaa - mm : jj T hh : mm : ss : fraction décimale de seconde.
+ `channel_arn` : ARN plus l'ID de canal Dans l'exemple précédent, le canal possède l'ID `5106412`.
+ `logger_name` : il peut être vide ou peut spécifier un nom qui relie une série de messages connexes.
+ `message` : message. N'oubliez pas que le libellé est susceptible d'être modifiée, vous ne devez donc pas automatiser ce seuil.
## Niveaux de log et verbosités pour les logs des encodeurs
Pour utiliser ce tableau, trouvez un niveau dans la première colonne, puis identifiez la gravité des messages qui apparaissent dans les journaux avec ce niveau de journalisation.
| Niveau | Messages de débogage | Messages d'information | Messages d'avertissement | Messages critiques | Messages fatals |
| --- | --- | --- | --- | --- | --- |
| DEBUG | Oui | Oui | Oui | Oui | Oui |
| INFO | | Oui | Oui | Oui | Oui |
| WARNING | | | Oui | Oui | Oui |
| ERROR | | | | Oui | Oui |
## Gestion du stockage des journaux
Lorsque vous supprimez une chaîne, les journaux associés restent dans CloudWatch les journaux. Vous continuerez à être facturé pour leur stockage jusqu'à ce que vous les supprimiez. Pour supprimer les journaux, modifiez la conservation des données de journaux. Toutes les données antérieures au paramètre de conservation que vous spécifiez seront supprimées. Pour plus d'informations, consultez le [guide de l'utilisateur d'Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html). Le **groupe de journaux** pour les journaux est **ElementalMediaLive**.