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.
# Utilisation d'Amazon CloudWatch Logs avec OpsWorks Stacks
**Important**
Le AWS OpsWorks Stacks service a atteint sa fin de vie le 26 mai 2024 et a été désactivé tant pour les nouveaux clients que pour les clients existants. Nous recommandons vivement aux clients de migrer leurs charges de travail vers d'autres solutions dès que possible. Si vous avez des questions sur la migration, contactez l' AWS Support équipe sur [AWS Re:Post](https://repost.aws/) ou via le [AWS Support](https://aws.amazon.com/support) Premium.
Pour simplifier le processus de surveillance des journaux sur plusieurs instances, OpsWorks Stacks prend en charge Amazon CloudWatch Logs. Vous activez CloudWatch les journaux au niveau de la couche dans OpsWorks Stacks. CloudWatch L'intégration des journaux fonctionne avec les stacks basés sur Linux Chef 11.10 et Chef 12. L'activation des CloudWatch journaux entraîne des frais supplémentaires. Consultez donc [ CloudWatchles tarifs Amazon](https://aws.amazon.com/cloudwatch/pricing/) avant de commencer.
CloudWatch Logs surveille les journaux sélectionnés pour détecter l'apparition d'un modèle spécifié par l'utilisateur. Par exemple, vous pouvez surveiller les journaux afin de détecter la présence d'un terme littéral comme `NullReferenceException` ou de compter le nombre de tels événements. Une fois que vous avez activé CloudWatch Logs in OpsWorks Stacks, l'agent OpsWorks Stacks envoie les journaux à CloudWatch Logs. Pour plus d'informations sur CloudWatch les journaux, consultez [Getting Started with CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_GettingStarted.html).
## Conditions préalables
Avant de pouvoir activer CloudWatch Logs, vos instances doivent exécuter la version 3444 ou ultérieure de l'agent OpsWorks Stacks dans les piles Chef 11.10, et la version 4023 ou ultérieure dans les piles Chef 12. Vous devez également utiliser un profil d'instance compatible pour toutes les instances que vous surveillez à l'aide CloudWatch des journaux.
Si vous utilisez un profil d'instance personnalisé (un profil que OpsWorks Stacks n'a pas fourni lorsque vous avez créé la pile), OpsWorks Stacks ne peut pas automatiquement mettre à niveau le profil d'instance. Vous devez associer manuellement la **AWSOpsWorksCloudWatchLogs**politique à votre profil à l'aide d'IAM. Pour plus d'informations, consultez [la section Gestion des politiques IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-using.html#attach-managed-policy-console) dans le Guide de l'*utilisateur IAM*.
Si vous devez mettre à niveau la version de votre agent ou le profil de votre instance, OpsWorks Stacks affiche un rappel similaire à la capture d'écran suivante lorsque vous ouvrez l'onglet CloudWatch Logs sur la page **Layer**.
![\[CloudWatch Onglet Logs sur la page Layer\]](http://docs.aws.amazon.com/fr_fr/opsworks/latest/userguide/images/cw_logs_upgrade.png)
La mise à jour de l'agent sur toutes les instances d'une couche peut prendre un peu de temps. Si vous essayez d'activer CloudWatch les journaux sur une couche avant que la mise à niveau de l'agent ne soit terminée, un message similaire au suivant s'affiche.
![\[CloudWatch Onglet Logs sur la page Layer\]](http://docs.aws.amazon.com/fr_fr/opsworks/latest/userguide/images/cloudwatch_logs_upgrade_time.png)
## Activation CloudWatch des journaux
1. Une fois que les mises à niveau requises des profils d'agent et d'instance sont terminées, vous pouvez activer les CloudWatch journaux en réglant le curseur de l'onglet **CloudWatch Logs** **sur** Activé.
![\[CloudWatch Contrôle du curseur des journaux\]](http://docs.aws.amazon.com/fr_fr/opsworks/latest/userguide/images/cw_logs_enable_switch.png)
1. Pour diffuser les journaux de commande, définissez le curseur **Diffuser les journaux de commande** sur **Activé**. Cela envoie à Logs les journaux des activités de Chef et des commandes initiées par l'utilisateur sur les instances de CloudWatch votre couche.
Les données incluses dans ces journaux correspondent étroitement à ce que vous voyez dans les résultats d'une [DescribeCommands](https://docs.aws.amazon.com/opsworks/latest/APIReference/API_DescribeCommands.html)opération lorsque vous ouvrez la cible de l'URL du journal. Cela comprend les données sur `setup`, `configure`, `deploy`, `undeploy`, `start`, `stop`, et les commandes d'exécution de recette.
1. Pour diffuser les journaux d'activités qui sont stockés sur les instances de votre couche, comme `/var/log/apache/myapp/mylog*`, tapez l'emplacement personnalisé dans la zone **Stream custom logs**, puis choisissez **Add** (**\$1**).
1. Choisissez **Enregistrer**. Au bout de quelques minutes, les flux de log de OpsWorks Stacks devraient être visibles dans la console CloudWatch Logs.
![\[CloudWatch Les journaux sont activés\]](http://docs.aws.amazon.com/fr_fr/opsworks/latest/userguide/images/cw_logs_enabled.png)
## Désactiver les CloudWatch journaux
Pour désactiver CloudWatch les journaux, modifiez les paramètres de votre couche.
1. Sur la page des propriétés de votre couche, choisissez **Modifier**.
![\[Bouton Modifier de la page Propriétés de la couche\]](http://docs.aws.amazon.com/fr_fr/opsworks/latest/userguide/images/cw_logs_enabled_edit.png)
1. Sur la page d'édition, choisissez l'onglet **CloudWatch Logs**.
1. Dans la zone **CloudWatch Journaux**, désactivez les **journaux des commandes Stream**. Sélectionnez **X** sur des journaux personnalisés afin de les supprimer des flux de journaux, le cas échéant.
1. Choisissez **Enregistrer**.
### Supprimer les journaux diffusés en continu des CloudWatch journaux
Une fois que vous avez désactivé le streaming CloudWatch des journaux depuis OpsWorks Stacks, les journaux existants sont toujours disponibles dans la console de gestion des CloudWatch journaux. Vous devez toujours payer des frais pour les journaux stockés, sauf si vous les exportez vers Amazon S3 ou si vous les supprimez. Pour plus d'informations sur l'exportation de journaux vers S3, consultez [Exportation de données de journaux vers Amazon S3](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/S3Export.html).
Vous pouvez supprimer des flux de journaux et des groupes de CloudWatch journaux dans la console de gestion des journaux ou en exécutant les [https://docs.aws.amazon.com/cli/latest/reference/logs/delete-log-group.html](https://docs.aws.amazon.com/cli/latest/reference/logs/delete-log-group.html) AWS CLI commandes [https://docs.aws.amazon.com/cli/latest/reference/logs/delete-log-stream.html](https://docs.aws.amazon.com/cli/latest/reference/logs/delete-log-stream.html)et. Pour plus d'informations sur la modification des périodes de conservation des journaux, voir [Conservation des données des journaux des modifications dans CloudWatch les journaux](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/SettingLogRetention.html).
## Gestion de vos connexions dans CloudWatch Logs
Les journaux que vous diffusez sont gérés dans la console CloudWatch Logs.
![\[CloudWatch Console de journalisation\]](http://docs.aws.amazon.com/fr_fr/opsworks/latest/userguide/images/cw_logs_dash.png)
OpsWorks crée automatiquement des groupes de journaux par défaut et des flux de journaux. Les groupes de journaux pour OpsWorks Stacks ont des noms qui correspondent au modèle suivant :
*stack\$1name*`/`*layer\$1name*`/`*chef\$1log\$1name*
Les journaux personnalisés ont des noms qui correspondent au modèle suivant :
*/stack\$1name/layer\$1short\$1name/file\$1path\$1name*. Le nom du chemin est rendu plus lisible par l'utilisateur grâce à la suppression des caractères spéciaux, tels que les astérisques (\$1).
Lorsque vous avez localisé vos CloudWatch journaux dans Logs, vous pouvez [les organiser en groupes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Create-Log-Group.html), [rechercher et filtrer les journaux en créant des filtres métriques](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/MonitoringLogData.html) et [créer des alarmes personnalisées](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html).
## Configuration des couches Windows Chef 12.2 pour utiliser les journaux CloudWatch
CloudWatch L'intégration automatique des journaux n'est pas prise en charge pour les instances Windows. L'onglet **CloudWatch Logs** n'est pas disponible sur les couches dans les piles Chef 12.2. Pour activer manuellement le streaming vers CloudWatch les instances basées sur Logs for Windows, procédez comme suit.
+ Mettez à jour le profil d'instance pour les instances Windows afin que l'agent CloudWatch Logs dispose des autorisations appropriées. La déclaration de **AWSOpsWorksCloudWatchLogs**politique indique les autorisations requises.
En général, vous n'effectuez cette tâche qu'une seule fois. Vous pouvez ensuite utiliser le profil d'instance mis à jour pour toutes les instances Windows dans une couche.
+ Modifiez le fichier de configuration JSON suivant sur chaque instance. Ce fichier comprend les préférences de flux de journaux, comme les journaux à surveiller.
`%PROGRAMFILES%\Amazon\Ec2ConfigService\Settings\AWS.EC2.Windows.CloudWatch.json`
Vous pouvez automatiser les deux tâches précédentes en créant des recettes personnalisées pour gérer les tâches requises et les attribuer aux événements **Setup** de la couche Chef 12.2. Chaque fois que vous démarrez une nouvelle instance sur ces couches, OpsWorks Stacks exécute automatiquement vos recettes une fois le démarrage de l'instance terminé, en CloudWatch activant Logs.
Pour désactiver CloudWatch les journaux sur les instances Windows, inversez le processus. Décochez la case **Activer l'intégration des CloudWatch journaux** dans la boîte de dialogue **Propriétés du EC2 service**, supprimez les préférences de flux de journaux du `AWS.EC2.Windows.CloudWatch.json` fichier et arrêtez d'exécuter les recettes Chef qui attribuent automatiquement CloudWatch des autorisations de journaux aux nouvelles instances des couches Chef 12.2.