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.
Utilisez les facettes pour regrouper et explorer les journaux
Les facettes sont utiles pour analyser les journaux car elles vous permettent de filtrer et de regrouper vos données de manière interactive sans exécuter de requêtes. Une facette est un champ de vos journaux (tel que ServiceName ouStatusCode) qui permet de filtrer, d'agréger et d'analyser les différents groupes de journaux. Vous pouvez consulter la liste des champs à facettes dans la console CloudWatch Logs Insights, ainsi que le nombre d'événements de journal pour chaque valeur de facette en fonction de la plage de temps que vous avez sélectionnée. Lorsque vous sélectionnez différentes facettes et valeurs, les valeurs et les comptes des facettes sont mis à jour en temps réel, ce qui vous permet d'explorer vos journaux de manière interactive.
Chaque facette affiche les valeurs disponibles et les comptes automatiquement extraits des champs de vos journaux en fonction de la plage de temps et de l'étendue de la requête sélectionnés, et conservés pendant 30 jours. Le nombre de facettes indiqué est approximatif. Vous pouvez utiliser les facettes par défaut, telles que le nom de la source de données ou le type de source de données, pour explorer vos journaux, ou créer des facettes personnalisées dans l'un des champs de vos journaux. Le nom de la source de données est un service ou une application AWS qui génère les journaux (par exemple, Route 53, Amazon VPC ou CloudTrail) et le type de source de données est le type spécifique de journal généré par ce service. Les facettes par défaut sont créées par CloudWatch et incluent @aws.region@data_source_name,@data_source_type, et@data_format. Pour de plus amples informations, veuillez consulter Gestion des journaux. Les facettes ne sont disponibles que pour les journaux ingérés dans le compte. Si vous avez configuré l'observabilité entre comptes, le compte de surveillance ne peut pas afficher les facettes en fonction des journaux des comptes sources.
Si les balises de ressources pour la télémétrie sont activées, les champs de balises de ressources (@aws.tag.*) sont automatiquement ajoutés en tant que facettes par défaut. Ces facettes vous permettent de filtrer et de regrouper les événements du journal en fonction des balises des ressources qui les ont produits.
Pour créer des facettes supplémentaires, sélectionnez les champs de vos journaux qui sont pertinents pour votre dépannage et configurez-les à l'aide des politiques d'index. Pour les facettes personnalisées, nous vous recommandons de les créer dans des champs à faible cardinalité (champs contenant moins de 100 valeurs uniques par jour, tels que Status et ApplicationName). Les facettes comportant plus de 100 valeurs uniques par jour sont classées comme étant à cardinalité élevée et les valeurs de ces facettes ne sont pas affichées. Sélectionnez une ou plusieurs facettes et choisissez d'exécuter des requêtes dans vos journaux.
Pour commencer à utiliser les facettes dans CloudWatch Logs Insights :
-
Ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/
. -
Dans le volet de navigation, choisissez Journaux, Informations sur les journaux.
-
(Facultatif) Utilisez le sélecteur de plage de temps pour sélectionner la période que vous souhaitez analyser. Pour la plage de temps sélectionnée, les facettes et les valeurs disponibles sont affichées dans le panneau.
-
Sélectionnez des facettes pour explorer vos données et consulter les mises à jour en temps réel des distributions de valeur entre les facettes.
Les facettes comportant plus de 100 valeurs uniques ne sont pas affichées. Pour interroger des valeurs spécifiques, utilisez plutôt des filtres dans votre requête.
Pour exécuter une requête basée sur les facettes
-
Sélectionnez une ou plusieurs valeurs parmi les facettes.
-
Le nombre d'événements sera mis à jour en fonction des facettes et des valeurs sélectionnées.
-
Au fur et à mesure que les valeurs des facettes sont sélectionnées, l'étendue de la requête est mise à jour pour refléter la sélection.
-
Après avoir sélectionné les valeurs des facettes, choisissez Exécuter pour exécuter votre requête.
-
Le nombre maximum de valeurs uniques prises en charge par facette est de 100. Par exemple, s'il existe plus de 100 valeurs pour une facette, tous les comptes sont affichés sous la forme « - », ce qui indique que les valeurs sont inconnues.
Pour enregistrer une requête basée sur des facettes
-
Créez votre requête à l'aide d'une ou de plusieurs valeurs de facette.
-
Les autres étapes sont identiques à l'enregistrement d'une requête Logs Insights. Consultez la section Requêtes Saving CloudWatch Logs Insights.
-
Vos requêtes enregistrées sont disponibles dans la section Requêtes enregistrées. Lorsque vous récupérez une requête enregistrée, elle inclut automatiquement les facettes et les valeurs utilisées pour la requête, ce qui facilite l'analyse de vos journaux.
Pour créer une facette au niveau du compte
-
Pour créer des facettes, vous devez d'abord créer le champ en tant qu'index et le configurer en tant que facette. Dans le volet de navigation, choisissez Paramètres, Journaux , Politiques d'indexation au niveau du compte. Vous pouvez également sélectionner Gérer les facettes dans le panneau des facettes.
-
Choisissez Créer une nouvelle politique d'indexation. Pour plus d'informations sur la création de politiques d'indexation, consultezCréation d'une politique d'indexation des champs au niveau du compte.
-
Pour créer une facette, cochez la case Définir comme facette pour le champ sélectionné sur la page de création de la politique d'index.
Gestion des facettes à l'aide d'API
La gestion des facettes peut être effectuée à l'aide de la politique d'indexation des champs. Consultez les field
index API pour plus de détails.
| Non. | Nom | Description |
|---|---|---|
| 1 | PutIndexPolicy | Crée ou met à jour une politique d'index de champs pour le groupe de journaux spécifique |
| 2 | PutAccountPolicy | Crée une politique de protection des données au niveau du compte, une politique de filtre d'abonnement, une politique d'index de champs, une politique de transformation ou une politique d'extraction de métriques qui s'applique à tous les groupes de journaux ou à un sous-ensemble de groupes de journaux du compte |
| 3 | DeleteIndexPolicy | Supprime une politique d'indexation de champs au niveau du groupe de journaux qui a été appliquée à un seul groupe de journaux |
| 4 | DeleteAccountPolicy | Supprime une politique de compte CloudWatch Logs |
