Régionaliser vos journaux

Ce document explique comment utiliser le récepteur _Default pour acheminer vos entrées de journal vers un bucket Cloud Logging situé dans une région spécifique. Pour obtenir la liste des régions prises en charge, consultez la page Emplacements.

Vous pouvez également définir un emplacement de stockage par défaut pour les nouveaux buckets _Default et _Required en configurant les paramètres par défaut de votre organisation ou de votre dossier. Pour en savoir plus, consultez Définir l'emplacement de stockage par défaut.

Ce guide vous explique ce processus en prenant l'exemple de la redirection de tous les journaux vers une seule région. Ce processus comprend les étapes suivantes :

  1. Créer un bucket de journaux dans la région désignée pour stocker les journaux.

  2. Rediriger le récepteur _Default afin d'acheminer les journaux vers le nouveau bucket de journaux.

  3. Rechercher des journaux dans l'explorateur de journaux.

Présentation

Dans Logging, les buckets de journaux sont des ressources régionales: l'infrastructure qui stocke, indexe et recherche vos journaux est située dans un emplacement géographique spécifique. À l'exception des buckets de journaux dans les régions global, eu ou us,Google Cloud gère l'infrastructure de sorte que vos applications soient disponibles de manière redondante dans les zones de la région du bucket de journaux.

Votre organisation peut être amenée à stocker ses données de journaux dans des régions spécifiques. Les principaux facteurs qui déterminent la région dans laquelle vos journaux sont stockés consistent, entre autres, à répondre aux exigences de latence, de disponibilité ou de conformité de votre organisation. Lorsque vous sélectionnez une région pour le stockage des journaux, tenez compte de l'emplacement des autres produits et servicesGoogle Cloud utilisés par votre application.

Si vous avez des exigences de résidence des données, n'activez pas les services qui peuvent interroger les données de journaux et stocker le résultat de la requête dans un emplacement global. Gemini Cloud Assist en est un exemple.

Concepts clés

Les concepts clés suivants s'appliquent à la régionalisation des données pour Logging.

Emplacements des routeurs de journaux

Le routeur de journaux traite toutes les entrées de journal écrites dans l'API Cloud Logging. Il vérifie chaque entrée de journal par rapport aux règles existantes pour déterminer les entrées de journal à stocker dans les buckets Logging et celles à acheminer vers les destinations compatibles à l'aide de récepteurs. Pour acheminer les journaux de manière fiable, le routeur de journaux les stocke également temporairement, ce qui permet de les mettre en mémoire tampon en cas d'interruption temporaire sur un récepteur.

Le routeur de journaux traite les journaux dans la région dans laquelle ils sont reçus. Le routeur de journaux peut envoyer des journaux vers une autre région en fonction de la définition d'un récepteur ou si vous avez choisi de partager des données de journaux avec un autre serviceGoogle Cloud , tel que la détection des menaces de Security Command Center. Les récepteurs s'appliquent aux journaux de manière égale, quelle que soit la région.

Emplacements des buckets de journaux

Les buckets de journaux sont les conteneurs de votre projetGoogle Cloud , de votre compte de facturation, de votre dossier et de votre organisation qui stockent et organisent les données de vos journaux.

Pour chaque projet Google Cloud , compte de facturation, dossier et organisation, Logging crée automatiquement deux buckets de journaux : _Required et _Default, qui se trouvent à l'emplacement global. Vous ne pouvez pas modifier l'emplacement des buckets existants. Toutefois, votre organisation peut créer une règle qui définit un emplacement par défaut différent pour ces buckets. Pour en savoir plus, consultez Configurer les paramètres par défaut pour les organisations et les dossiers.

Vous pouvez également créer des buckets de journaux définis par l'utilisateur pour n'importe quel projetGoogle Cloud . Lorsque vous créez un bucket de journaux défini par l'utilisateur, vous pouvez spécifier son emplacement. Une fois le bucket de journaux créé, vous ne pouvez plus modifier son emplacement. Toutefois, vous pouvez créer un autre bucket et y rediriger les entrées de journaux à l'aide de récepteurs. Pour savoir comment définir l'emplacement de vos buckets, consultez Régionaliser vos journaux.

La journalisation permet d'interroger les journaux de plusieurs régions à la fois. Dans ce cas, les requêtes sont traitées dans les mêmes emplacements que les buckets interrogés, puis agrégées dans la région d'où provient la requête pour renvoyer les résultats.

La région d'un bucket de journaux est indiquée sur la page Stockage des journaux et dans certaines boîtes de dialogue. Par exemple, lorsque vous accédez à la page "Explorateur de journaux" et que vous utilisez le sélecteur Affiner le champ d'application pour lister les vues de journaux, les informations sur la région s'affichent également. Pour ce sélecteur, lorsque la région est global, la région et l'emplacement de stockage actuel s'affichent dans un format semblable à GLOBAL (US-WEST4).

Avant de commencer

  1. Identifiez le projet Google Cloud qui stockera vos entrées de journal.
  2. Identifiez le nom et l'emplacement du bucket de journaux qui stockera vos entrées de journal.
  3. Déterminez les entrées de journal que vous souhaitez acheminer vers votre bucket de journaux. Dans ce guide, nous incluons tous les journaux routés par le récepteur _Default.

  4. Dans la console Google Cloud , activez Cloud Shell.

    Activer Cloud Shell

    En bas de la console Google Cloud , une session Cloud Shell démarre et affiche une invite de ligne de commande. Cloud Shell est un environnement shell dans lequel Google Cloud CLI est déjà installé, et dans lequel des valeurs sont déjà définies pour votre projet actuel. L'initialisation de la session peut prendre quelques secondes.

Régions où le service est disponible

Lorsque vous créez votre bucket de journaux, vous pouvez choisir où stocker vos journaux. Pour obtenir la liste des régions prises en charge, consultez Emplacements.

Créer le bucket de journaux

Les buckets de journaux stockent les entrées de journaux. Les projets, les dossiers et les organisations contiennent des collecteurs de journaux qui acheminent les entrées de journal vers des buckets de journaux ou d'autres destinations. Lorsque la destination d'un récepteur est un bucket de journaux, ce bucket peut se trouver dans la même ressource que le récepteur de journaux ou dans une autre ressource. Pour en savoir plus, consultez la page Configurer les buckets de journaux.

  1. Ouvrez un shell.

    Par exemple, pour utiliser Cloud Shell, procédez comme suit :

    1. Accédez à la console Google Cloud  :

      Accéder à la console Google Cloud

    2. Dans la barre d'outils, cliquez sur  Activer Cloud Shell.

  2. Pour créer un bucket de journaux, exécutez la commande gcloud logging buckets create dans le shell. Avant d'exécuter l'exemple de commande, effectuez les remplacements suivants :

    • BUCKET_ID : nom ou ID du bucket de journaux.
    • LOCATION : emplacement du bucket de journaux.
    • PROJECT_ID : identifiant du projet.

    Exemple de commande :

    gcloud logging buckets create BUCKET_ID \
  --location=LOCATION \
  --project=PROJECT_ID

  3. Vérifiez que le bucket a été créé :

    gcloud logging buckets list --project=PROJECT_ID

Une fois votre bucket de journaux créé, vous pouvez modifier certaines de ses propriétés, comme la description et la période de conservation des données. Pour effectuer ces modifications, utilisez la commande gcloud logging buckets update.

Rediriger le récepteur de journaux _Default

Pour acheminer des journaux vers un bucket de journaux, vous devez créer un récepteur. Un récepteur inclut un filtre qui sélectionne les entrées de journal à exporter via le récepteur, et une destination. Dans ce guide, nous mettons à jour le récepteur _Default existant pour acheminer les entrées de journal vers le bucket de journaux créé à l'étape précédente.

Pour mettre à jour un récepteur, exécutez la commande gcloud logging sinks update. Avant d'exécuter l'exemple de commande, effectuez le remplacement suivant :

  • _Default : cet exemple met à jour la destination du récepteur nommé _Default. Si vous souhaitez mettre à jour un autre récepteur, modifiez le nom de cette variable.
  • BUCKET_ID : nom ou ID du bucket de journaux.
  • LOCATION : emplacement du bucket de journaux.
  • PROJECT_ID : identifiant du projet.

Exemple de commande :

gcloud logging sinks update _Default \
  logging.googleapis.com/projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID \
  --log-filter='NOT LOG_ID("cloudaudit.googleapis.com/activity") AND NOT
    LOG_ID("externalaudit.googleapis.com/activity") AND NOT
    LOG_ID("cloudaudit.googleapis.com/system_event") AND NOT
    LOG_ID("externalaudit.googleapis.com/system_event") AND NOT
    LOG_ID("cloudaudit.googleapis.com/access_transparency") AND NOT
    LOG_ID("externalaudit.googleapis.com/access_transparency")' \
  --description="Updated the _Default sink to route logs to the LOCATION region"

Créer une entrée de journal pour tester le récepteur

Pour vérifier que le récepteur a bien été mis à jour, procédez comme suit :

  1. Envoyez un message de journal de test à votre bucket régionalisé à l'aide de la commande gcloud logging write. Avant d'exécuter l'exemple de commande, effectuez les remplacements suivants :

    • LOG_NAME : nom de votre journal.
    • BUCKET_ID : nom ou ID du bucket de journaux.
    • PROJECT_ID : identifiant du projet.

    Exemple de commande :

    gcloud logging write LOG_NAME "Test to route logs to BUCKET_ID" \
--project=PROJECT_ID

  2. Affichez votre entrée de journal :

    1. Dans la console Google Cloud , accédez à la pageExplorateur de journaux :

      Accéder à l'explorateur de journaux

      Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.

    2. Dans la barre d'outils, cliquez sur Affiner le champ d'application, puis sélectionnez Projet actuel.

      L'explorateur de journaux est configuré pour afficher les entrées de journal provenant de votre projet.

    3. Dans le volet Champs de journal, sélectionnez le type de ressource Global.

    4. Votre entrée de journal de test s'affiche dans le panneau Résultats de la requête.

Rechercher des journaux dans la console Google Cloud

Pour afficher les entrées de journal dans votre bucket de journaux, accédez à la consoleGoogle Cloud et procédez comme suit :

  1. Dans la console Google Cloud , accédez à la pageExplorateur de journaux :

    Accéder à l'explorateur de journaux

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.

  2. Sélectionnez Affiner le niveau d'accès.

  3. Dans le panneau Affiner le champ d'application, sélectionnez Affichage des journaux.

  4. Sélectionnez la vue _AllLogs associée à votre BUCKET_NAME.

  5. Cliquez sur Appliquer.

    L'explorateur de journaux s'actualise pour afficher les journaux du bucket.

    Pour en savoir plus sur l'utilisation de l'explorateur de journaux, consultez Afficher les journaux à l'aide de l'explorateur de journaux.

Étapes suivantes