Exclusions de journaux

La page Logs ingestion (Ingestion de journaux) dans Stackdriver Logging suit le volume de journaux dans votre projet. Elle vous fournit également des outils permettant de désactiver l'ingestion de tous les journaux ou d'exclure (ignorer) les entrées de journal qui ne vous intéressent pas, de façon à réduire au minimum les frais de journaux encourus au-delà de votre attribution mensuelle. Pour en savoir plus sur la manière dont sont traitées les entrées de journal exclues, consultez la section Présentation des exclusions sur cette page.

Pour plus de détails sur les coûts de Stackdriver Logging, consultez la page Tarifs de Stackdriver. Notez que si vous envoyez puis excluez vos journaux de flux de cloud privé virtuel (VPC) depuis Stackdriver Logging, des frais de génération de journaux de flux VPC s'appliquent.

Suivre l'utilisation des journaux

Pour suivre le volume des journaux de votre projet, accédez à la page Logs ingestion (Ingestion de journaux) dans la console Stackdriver Logging :

Accéder à la page "Logs ingestion" ("Ingestion de journaux")

En haut de la page, vous pouvez voir un récapitulatif des journaux que votre projet reçoit :

Récapitulatif de l'ingestion de journaux

Quatre chiffres sont affichés :

  • Last month's ingested log volume (Volume des journaux ingérés le mois dernier) : quantité de journaux reçus par votre projet au cours du dernier mois civil.

  • This month's ingested log volume (Volume des journaux ingérés ce mois-ci) : quantité de journaux reçus par votre projet depuis le premier jour du mois en cours.

  • Excluded log volume (Volume des journaux exclus) : quantité de journaux que vous avez exclus de votre projet depuis le premier jour du mois en cours. Ce nombre n'est pas inclus dans le volume des journaux ingérés ce mois-ci. L'exclusion de journaux est décrite plus loin sur cette page.

  • Projected ingestion log volume (Volume d'ingestion de journaux prévu) : quantité estimée de journaux que votre projet aura reçus à la fin du mois en cours, en fonction de l'utilisation actuelle.

Les volumes de journaux n'incluent pas les journaux d'audit activés par défaut, à savoir tous les journaux relatifs aux activités d'administration et les journaux d'accès aux données BigQuery. Ces journaux sont gratuits et ne peuvent pas être exclus.

Vous pouvez également voir la répartition de l'utilisation des journaux par type de ressource. Consultez la section Afficher les exclusions de types de ressources de cette page.

Arrêter l'ingestion de tous les journaux

Pour désactiver immédiatement l'ingestion de tous les journaux, procédez comme suit à partir de la page Logs ingestion (Ingestion de journaux) :

  1. Accédez à la page Logs ingestion (Ingestion de journaux) de la console Stackdriver Logging pour le projet dont vous souhaitez gérer les journaux.

    Accéder à la page "Logs ingestion" ("Ingestion de journaux")

  2. Au-dessus des statistiques récapitulatives, cliquez sur le bouton Logs Enabled (Journaux activés).

  3. Une boîte de dialogue Désactiver l'ingestion de tous les journaux ? s'affiche. Cliquez sur Désactiver les journaux.

  4. Si vous avez désactivé l'ingestion de tous les journaux, les modifications suivantes apparaissent dans la console Stackdriver Logging :

    Ingestion de journaux désactivée

    • Le bouton sur lequel vous avez cliqué à l'étape 2 se présente désormais sous le nom Logs Disabled (Journaux désactivés).
    • Une bannière est affichée en haut de chaque page de la console Stackdriver Logging et indique : Logs ingestion is turned off (L'ingestion de journaux est désactivée). No logs are being sent to Stackdriver Logging. (Aucun journal n'est envoyé à Stackdriver Logging.)
    • Un filtre nommé google-ui-logs-ingestion-off se trouve dans l'onglet Exclusions de la page Logs ingestion (Ingestion de journaux). Sa valeur Percent to Exclude (Pourcentage à exclure) est définie sur 100 %, tandis que le champ Exclusion Status (État de l'exclusion) est défini sur Active (Actif).

Pour réactiver immédiatement l'ingestion des journaux, cliquez sur le bouton Logs Disabled (Journaux désactivés) au-dessus des statistiques récapitulatives. Le bouton est à présent nommé Logs Enabled (Journaux activés) et la bannière ne s'affiche plus sur votre console Stackdriver Logging.

Présentation des exclusions

Le schéma suivant illustre la manière dont sont traitées les entrées de journal exclues dans Stackdriver Logging :

Cycle de vie d'un journal

Les conditions suivantes s'appliquent aux entrées de journal exclues dans Logging :

  • Les entrées de journal exclues ne sont pas prises en compte dans le quota d'attribution Logging associé aux projets. Consultez la section Informations sur Logging pour en savoir plus.

  • Les entrées de journal exclues ne sont pas visibles dans la visionneuse de journaux, elles ne sont pas comptabilisées dans les métriques basées sur les journaux, et elles ne sont pas disponibles pour Stackdriver Error Reporting ni Stackdriver Debugger.

  • Vous pouvez exporter les entrées de journal avant qu'elles ne soient exclues. Pour en savoir plus, consultez la section Exporter les journaux.

  • Vous ne pouvez pas exclure les journaux d'audit activés par défaut. Cependant, ceux-ci sont gratuits.

  • Vous ne pouvez pas exclure les journaux AWS ni les journaux de sources autres que GCP.

Il existe deux types d'exclusions :

  • Les filtres d'exclusion vous permettent de sélectionner les entrées de journal à exclure en fonction d'expressions de filtre. Vous pouvez utiliser des filtres d'exclusion pour choisir un échantillon aléatoire d'entrées de journal à exclure. Pour plus de détails, consultez la section Utiliser les filtres d'exclusion.

  • Les exclusions de types de ressources vous permettent de bloquer tous les journaux de types de ressources spécifiques. Pour en savoir plus, consultez la section Utiliser les exclusions de types de ressources.

Pour décider des entrées de journal à exclure, Logging prend en compte les deux types d'exclusions. Si une exclusion de type de ressource ou un filtre d'exclusion correspond à une entrée de journal, celle-ci est exclue.

Utiliser les filtres d'exclusion

En créant des filtres d'exclusion, vous pouvez contrôler exactement quelles entrées de journal vous souhaitez exclure. Par exemple, vous pouvez exclure les entrées de journal d'une instance de VM isolée plutôt que de celles de toutes les instances de VM.

Si vous utilisez à la fois des filtres d'exclusion et des exclusions de types de ressources, les deux peuvent se chevaucher. Une entrée de journal sera exclue si elle provient d'un type de ressource désactivé ou si elle correspond à l'un des filtres d'exclusion décrits dans cette section. Notez qu'il s'agit d'une distinction technique, car comme mentionné précédemment, Logging exécute les exclusions de types de ressources à l'aide de filtres d'exclusion.

La table affichée sous l'onglet Ingestions de la page Logs ingestion (Ingestion de journaux) est organisée par type de ressource, et prend en compte à la fois les exclusions de types de ressources et les filtres d'exclusion. Même si vous n'utilisez pas d'exclusion de type de ressource, cette table vous permet de suivre l'effet qu'ont les filtres d'exclusion sur vos données.

Afficher les filtres d'exclusion

Pour afficher les filtres d'exclusion actifs, y compris les filtres créés par Logging pour exécuter vos exclusions de types de ressources, procédez comme suit :

  1. Consultez la page Logs ingestion (Ingestion de journaux) de la console Stackdriver Logging. Sélectionnez le projet dont vous souhaitez gérer les journaux.

    Accéder à la page "Logs ingestion" ("Ingestion de journaux")

  2. Sous les statistiques récapitulatives, cliquez sur l'onglet Exclusions. Dans la table Exclusion Filters (Filtres d'exclusion), une liste de vos filtres d'exclusion est affichée (le cas échéant) :

    Table des filtres d'exclusions

Si vous avez arrêté l'ingestion de tous les journaux, votre liste inclut un filtre d'exclusion nommé google-ui-logs-ingestion-off. Vous pouvez supprimer ou désactiver ce filtre à l'aide du menu situé à droite du filtre.

Créer des filtres d'exclusion

Pour créer un filtre d'exclusion à l'aide de la console Stackdriver Logging, procédez comme suit :

  1. Accédez à la page Logs ingestion (Ingestion de journaux) de la console Stackdriver Logging et sélectionnez l'onglet Exclusions.

    Accéder à la page "Logs ingestion" ("Ingestion de journaux")

  2. Cliquez sur Create Exclusion (Créer une exclusion). Le volet Exclusion Editor (Éditeur d'exclusions) s'affiche à côté du panneau de la visionneuse de journaux :

    Créer une exclusion

  3. Dans le panneau de la visionneuse de journaux, saisissez une expression de filtre correspondant aux entrées de journal que vous souhaitez exclure. Pour en savoir plus sur le panneau, consultez la section relative aux interfaces utilisateur.

  4. Dans le panneau Exclusion Editor (Éditeur d'exclusions), finissez de remplir les détails de votre filtre :

    • Name (Nom) : saisissez un nom qui identifie l'exclusion, par exemple low-severity.
    • Description : saisissez une description plus détaillée du filtre, par exemple Exclude logs whose severity is less than WARNING.
    • Percent to Exclude (Pourcentage à exclure) : saisissez une valeur entière ou à virgule flottante comprise entre 0 et 100. Par exemple, saisissez 100 ou 100.0 pour exclure toutes les entrées de journal correspondantes. Saisissez 99.50 pour exclure 99,5 % des entrées correspondantes, mais en conserver 0,5 % dans Logging.
  5. Cliquez sur Créer une exclusion pour créer et appliquer l'exclusion.

Conseil : Si vous souhaitez empêcher l'utilisation de votre filtre d'exclusion, sélectionnez Désactiver l'exclusion dans le menu situé à droite de votre filtre d'exclusion. Vous pouvez également modifier ou supprimer votre filtre d'exclusion dans le même menu.

Interrompre les exclusions

Vous pouvez arrêter d'exclure tout ou partie des journaux de plusieurs manières :

  • Pour arrêter d'exclure tous les journaux : sur la page Logs ingestion (Ingestion de journaux), cliquez sur le bouton Logs Disabled (Journaux désactivés) en haut de l'écran. Si vous avez déjà désactivé l'ingestion de tous les journaux, le bouton passera de "Logs Disabled" (Journaux désactivés) à Logs Enabled (Journaux activés). Consultez la section Arrêter l'ingestion de tous les journaux pour en savoir plus.

  • Pour arrêter d'exclure les journaux par type de ressource : dans l'onglet Ingestions de la page Logs ingestion (Ingestion de journaux), cliquez sur Activer la source de journaux dans le menu situé à droite du type de ressource que vous ne souhaitez plus exclure.

  • Pour désactiver ou supprimer un filtre d'exclusion : dans l'onglet Exclusions de la page Logs ingestion (Ingestion de journaux), supprimez ou désactivez les filtres d'exclusion qui ciblent les entrées de journal que vous souhaitez recevoir. Pour en savoir plus, consultez la section Modifier les exclusions.

Conseil : Vérifiez tous vos filtres d'exclusion, car certaines entrées de journal pourraient être ciblées par plusieurs filtres.

Modifier les exclusions

Vous pouvez modifier vos filtres d'exclusion existants afin d'exclure davantage ou moins d'entrées de journal.

  1. Accédez à la page Logs ingestion (Ingestion de journaux) dans la console Stackdriver Logging et cliquez sur l'onglet Exclusions.

    Accéder à la page "Logs ingestion" ("Ingestion de journaux")

  2. Choisissez un filtre d'exclusion et sélectionnez Modifier l'exclusion dans le menu situé à droite du filtre.

  3. Modifiez le filtre de journaux avancé ou modifiez la valeur Pourcentage à exclure. Si vous modifiez le filtre, vérifiez l'aperçu des entrées de journal correspondantes. Vous ne pouvez pas modifier le nom du filtre d'exclusion.

  4. Cliquez sur Mettre à jour l'exclusion.

Bonne pratique : Ne modifiez pas et ne supprimez pas les filtres d'exclusion créés par Logging dans le cadre des exclusions de type ressource. Gérez plutôt ces filtres à l'aide des options Désactiver la source de journaux et Activer la source de journaux de l'onglet Ingestions.

Utiliser les exclusions de types de ressources

Par défaut, votre projet reçoit tous les journaux de tous les types de ressources. Pour supprimer tous les journaux de certains types de ressources, utilisez des exclusions de types de ressources.

Les exclusions de types de ressources sont une fonctionnalité de la console Stackdriver Logging. Lorsque vous créez une exclusion de type de ressource, Logging crée un filtre d'exclusion qui exécute l'exclusion. Pour en savoir plus, consultez la section Utiliser les filtres d'exclusion.

Afficher les exclusions de types de ressources

Pour afficher l'utilisation de vos journaux par type de ressource et pour voir les exclusions de types de ressources, procédez comme suit :

  1. Accédez à la page Logs ingestion (Ingestion de journaux) dans la console Stackdriver Logging :

    Accéder à la page "Logs ingestion" ("Ingestion de journaux")

  2. Sélectionnez l'onglet Ingestion (sélectionné par défaut) sous les informations récapitulatives. Dans la table Logs Ingestion (Ingestion de journaux), l'utilisation de vos journaux est affichée par type de ressource :

    Tableau d'utilisation des ressources

La table affiche les informations d'utilisation des journaux pour chaque type de ressource ayant envoyé des journaux à votre projet pendant le mois en cours et le mois précédent. Il est possible que des types de ressources ayant envoyé des journaux le mois dernier mais pas ce mois-ci soient également affichés dans la table.

La colonne Ingestion Status (État de l'ingestion) donne une indication approximative de l'existence d'exclusions pour chaque type de ressource. L'état peut être l'un des suivants :

  • Non ingérés : il existe une ou plusieurs exclusions qui ciblent exactement ce type de ressource à 100 % du taux d'échantillonnage. Cela signifie que le filtre d'exclusion cible précisément resource.type=[THIS_RESOURCE_TYPE].

  • All ingested (Complètement ingérés) : aucune entrée de journal de ce type de ressource n'a été exclue jusqu'à présent ce mois-ci et aucune exclusion ne cible précisément ce type de ressource.

  • Partiellement ingérés : il existe une ou plusieurs exclusions qui ciblent ce type de ressource entre 0 % et 100 % du taux d'échantillonnage. Si des entrées de journal ont été exclues ce mois-ci pour ce type de ressource, cet état est alors conservé jusqu'à la fin du mois, même si toutes les exclusions sont supprimées. Pour en savoir plus, consultez la section Modifier les exclusions.

Vous pouvez également inspecter les exclusions de types de ressources dans l'onglet Exclusions. Logging exécute les exclusions de types de ressources en créant des filtres d'exclusion. Consultez la section Afficher les filtres d'exclusion.

Créer des exclusions de types de ressources

Pour exclure (supprimer) tous les journaux d'un type de ressource spécifique, créez une exclusion de type ressource. Procédez comme suit :

  1. Accédez à la page Logs ingestion (Ingestion de journaux) dans la console Stackdriver Logging :

    Accéder à la page "Logs ingestion" ("Ingestion de journaux")

  2. Sélectionnez l'onglet Ingestions (valeur par défaut) sous les statistiques. Dans la table Logs Ingestion (Ingestion de journaux), l'utilisation de vos journaux est affichée par type de ressource, comme indiqué dans la capture d'écran de la section précédente.

  3. Dans la table, recherchez la ligne correspondant au type de ressource que vous souhaitez exclure.

  4. Sélectionnez Créer un filtre d'exclusion basé sur cette ressource dans le menu à droite de la ligne du tableau.

  5. Dans le panneau Exclusion Editor (Éditeur d'exclusions), finissez de remplir les détails de votre filtre :

    • Name (Nom) : saisissez un nom qui identifie l'exclusion, par exemple low-severity.
    • Description : saisissez une description plus détaillée du filtre, par exemple Exclude logs whose severity is less than WARNING.
    • Percent to Exclude (Pourcentage à exclure) : saisissez une valeur entière ou à virgule flottante comprise entre 0 et 100. Par exemple, saisissez 100 ou 100.0 pour exclure toutes les entrées de journal correspondantes. Saisissez 99.50 pour exclure 99,5 % des entrées correspondantes, mais en conserver 0,5 % dans Logging.
  6. Cliquez sur Créer une exclusion pour créer et appliquer l'exclusion.

Pour arrêter d'exclure les journaux de ce type de ressource, cliquez sur Activer la source de journaux dans le menu.

Exclusions dans l'API

Pour créer des filtres d'exclusion dans l'API Stackdriver Logging, appelez la méthode projects.exclusions.create. Il existe également des méthodes pour afficher, supprimer et mettre à jour les filtres d'exclusion.

L'API contient également des méthodes d'exclusion pour les journaux reçus par les organisations, les comptes de facturation et les dossiers. Ces exclusions ne peuvent être créées que dans l'API Stackdriver Logging. Elles ne sont pas compatibles avec la console Stackdriver Logging.

Pour voir des exemples de filtres de journaux pouvant être utiles dans les exclusions, consultez la page Filtres de journaux avancés.

Exclusions de types de ressources dans l'API

Les exclusions de types de ressources ne constituent pas un type distinct d'exclusion dans l'API. Pour créer une exclusion qui supprime toutes les entrées de journal d'un type de ressource particulier, créez un filtre d'exclusion avec un filtre de journaux spécifiant le type de ressource :

resource.type = [THE_RESOURCE_TYPE]

Exclusions échantillonnées dans l'API

Pour exclure moins de 100 % des entrées de journal correspondantes, utilisez la fonction sample de votre filtre de journaux.

Limites d'exclusion

Vous pouvez définir jusqu'à 50 filtres d'exclusion dans un même projet. Cela inclut les filtres d'exclusion et les exclusions de types de ressources créées dans la console Stackdriver Logging ou dans l'API.

Exporter les journaux exclus

Vous pouvez exporter les entrées de journal vers Cloud Storage, BigQuery ou Cloud Pub/Sub avant de les exclure, afin de ne pas les perdre définitivement.

Les journaux exportés entraînent des frais de destination. Notez également que si vous exportez vos journaux de flux VPC puis que vous les supprimez de Stackdriver Logging, des frais de génération des journaux de flux VPC s'appliquent en plus des frais de destination.

Pour commencer à appliquer votre exclusion et exporter les entrées de journal, procédez comme suit :

  1. Créez un filtre de journaux avancé qui correspond aux entrées de journal que vous souhaitez exclure et exporter.

    Conseil : Définissez le filtre de sorte qu'il ne corresponde à aucun journal d'audit{/} activé par défaut. La correspondance de ces entrées de journal d'audit n'affecte pas les exclusions, mais elle provoque l'exportation de nombreuses entrées de journal supplémentaires.

  2. Créez un récepteur d'exportation à l'aide de votre filtre de journaux et commencez à exporter les entrées de journal correspondantes.

  3. Créez un filtre d'exclusion à l'aide de votre filtre de journaux et commencez à exclure les entrées de journal correspondantes.

Pour interrompre les exclusions et l'exportation, désactivez le filtre d'exclusion, puis le récepteur d'exportation.

Pour en savoir plus sur l'exportation de journaux, consultez la page Exporter des journaux.

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Stackdriver Logging
Besoin d'aide ? Consultez notre page d'assistance.