Cette page a été traduite par l'API Cloud Translation.

Configurer des buckets de journaux

Ce document explique comment créer et gérer des buckets Cloud Logging à l'aide de la console Google Cloud, Google Cloud CLI et API Logging : Il fournit également des instructions pour créer et gérer des buckets de journaux au niveau au niveau du projet Google Cloud. Vous ne pouvez pas créer de buckets de journaux au niveau du dossier ou de l'organisation. Toutefois, Cloud Logging crée automatiquement des buckets de journaux _Default et _Required au niveau du dossier et de l'organisation.

Vous pouvez mettre à niveau des buckets de journaux pour utiliser Log Analytics. L'Analyse de journaux vous permet d'exécuter des requêtes SQL sur vos données de journaux résoudre les problèmes liés aux applications, à la sécurité et aux réseaux.

Pour utiliser BigQuery pour analyser vos données de journalisation, vous avez deux options :

Mettez à niveau un bucket de journaux pour utiliser l'Analyse de journaux, puis créez un ensemble de données BigQuery associé. Dans ce scénario, Logging stocke vos données de journaux, mais BigQuery peut les lire.
Exportez vos entrées de journal vers BigQuery. Dans ce scénario, vous devez créer un récepteur. BigQuery stocke et gère les données, et vous avez la possibilité d'utiliser des tables partitionnées.

Lorsque vos données de journaux sont disponibles pour BigQuery, vous pouvez les joindre à d'autres données stockées dans BigQuery. Vous pouvez également y accéder à partir d'autres outils, comme Looker Studio et Looker.

Pour obtenir une présentation des concepts liés aux buckets, consultez la page Présentation du routage et du stockage : buckets de journaux.

Ce document n'explique pas comment créer un bucket de journaux qui utilise une clé de chiffrement gérée par le client (CMEK). Si ce sujet vous intéresse, puis consultez Configurez une clé CMEK pour le stockage des journaux.

Avant de commencer

Pour faire vos premiers pas avec les buckets, procédez comme suit :

Configurez votre projet Google Cloud :
1. Make sure that billing is enabled for your Google Cloud project.
2. Pour obtenir les autorisations nécessaires pour créer, mettre à niveau et associer un bucket de journaux, demandez à votre administrateur de vous accorder le rôle IAM Rédacteur de configuration des journaux (roles/logging/configWriter) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.
  
  Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.
  
  Pour obtenir la liste complète des autorisations et des rôles, consultez la section Contrôle des accès avec IAM.
3. Facultatif : Pour afficher les données stockées dans un bucket de journaux à l'aide de BigQuery, procédez comme suit :
  1. Vérifiez que l'API BigQuery est activée. Vous pouvez vérifier que l'API est activée en listant les services disponibles.
  2. Votre rôle Identity and Access Management inclut les autorisations qui vous permettent de créer un ensemble de données associé. Pour en savoir plus, consultez Autorisations pour les ensembles de données BigQuery associés.
Familiarisez-vous avec les régions disponibles dans lesquelles vous pouvez stocker vos journaux.
Select the tab for how you plan to use the samples on this page:
Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
REST

Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.
Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud.
Si vous prévoyez d'utiliser la Google Cloud CLI ou l'API Cloud Logging pour créer ou gérer vos buckets de journaux, vous devez connaître les exigences de mise en forme de LogBucket.

Créer un bucket

Vous pouvez créer jusqu'à 100 buckets par projet Google Cloud.

Pour créer un bucket de journaux défini par l'utilisateur pour votre projet Google Cloud, procédez comme suit : suivantes:

console Google Cloud

Pour créer un bucket de journaux dans votre projet Google Cloud, procédez comme suit :

Dans la console Google Cloud, accédez à la page Stockage des journaux.
Accéder à la page Stockage des journaux

Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.
Cliquez sur Créer un bucket de journaux.
Saisissez un nom et une description pour votre bucket.
Facultatif : Mettez à niveau votre bucket pour utiliser l'Analyse de journaux.

Remarque :Une fois qu'un bucket de journaux a été mis à niveau pour utiliser l'Analyse de journaux, vous reconfigurer le bucket de journaux pour modifier ou supprimer l'utilisation Analyse de journaux.
1. Sélectionnez Effectuez la mise à niveau pour utiliser l'Analyse de journaux.
  
  Lorsque vous mettez à niveau un bucket pour utiliser l'Analyse de journaux, vous pouvez interroger vos journaux sur la page Analyse de journaux à l'aide de requêtes SQL. Toi vous pouvez aussi continuer à consulter vos journaux à l'aide de l'explorateur de journaux.
2. Facultatif: Pour afficher vos journaux dans BigQuery, sélectionnez Créez un ensemble de données BigQuery associé à ce bucket et saisissez un nom unique pour cet ensemble de données.
  
  Lorsque vous sélectionnez cette option, BigQuery peut lire les données stockées dans votre bucket de journaux. Vous pouvez désormais effectuer des requêtes dans l'interface BigQuery, où vous pouvez joindre vos données de journal et accéder aux données d'autres outils tels que Looker Studio et Looker.
Facultatif : Pour sélectionner la région de stockage de vos journaux, cliquez sur le menu Sélectionner la région du bucket de journaux et sélectionnez une région. Si vous ne sélectionnez pas de région, la région global est utilisée, ce qui signifie que les journaux peuvent se trouver physiquement dans n'importe quelle région compatible.

Remarque : Une fois le bucket de journaux créé, vous ne pouvez plus modifier la région de votre bucket. Si vous avez besoin d'un bucket situé dans une autre région, vous devez créer un bucket de cette région, rediriger les récepteurs appropriés vers le nouveau bucket, puis supprimer l'ancien bucket.
Facultatif : Pour définir une période de conservation personnalisée pour les journaux du bucket, cliquez sur Suivant.

Dans le champ Durée de conservation, saisissez un nombre de jours compris entre 1 jour et 3 650 jours, pendant lesquels Cloud Logging de conserver vos journaux. Si vous ne personnalisez pas la durée de conservation, la valeur par défaut est 30 days.

Vous pouvez également mettre à jour votre bucket pour appliquer une durée de conservation personnalisée après sa création.
Cliquez sur Create bucket (Créer un bucket).

Une fois le bucket de journaux créé, Logging met à niveau bucket et crée le lien vers l'ensemble de données, si ces options sont sélectionnées.

L'exécution de ces étapes peut prendre un certain temps.

gcloud

Pour ne créer qu'un bucket de journaux, exécutez la commande gcloud logging buckets create. Si vous souhaitez mettre à niveau le bucket de journaux pour utiliser Log Analytics, incluez les options --enable-analytics et --async, et veillez à définir la variable LOCATION sur une région compatible :

gcloud logging buckets create BUCKET_ID --location=LOCATION --enable-analytics --async OPTIONAL_FLAGS

L'option --async force la soit asynchrone. Le retour de une méthode asynchrone est un objet Operation, elle contient des informations sur la progression de la méthode. Lorsque est terminée, l'objet Operation contient l'état. Pour plus plus d'informations, consultez la section Méthodes d'API asynchrones.

Si vous ne souhaitez pas mettre à niveau le bucket de journaux pour utiliser l'Analyse de journaux : omettez les --enable-analytics et --async.

Par exemple, si vous souhaitez créer un bucket avec l'élément BUCKET_ID my-bucket dans la région global, votre commande se présente comme suit :

gcloud logging buckets create my-bucket --location global --description "My first bucket"

Par exemple, pour créer un bucket avec le bucket BUCKET_ID my-upgraded-bucket à l'emplacement global, puis mettre à niveau le bucket de journaux pour utiliser l'Analyse de journaux, la commande se présente comme suit:

gcloud logging buckets create my-upgraded-bucket --location global \
      --description "My first upgraded bucket" \
      --enable-analytics --retention-days=45

REST

Pour créer un bucket, utilisez la méthode projects.locations.buckets.create ou projects.locations.buckets.createAsync. Préparez les arguments de la méthode comme suit :

Définissez le paramètre parent comme étant la ressource dans laquelle pour créer le bucket: projects/PROJECT_ID/locations/LOCATION

La variable LOCATION fait référence à la région dans laquelle vous souhaitez stocker vos journaux.

Par exemple, si vous souhaitez créer un bucket pour le projet my-project dans la région global, votre paramètre parent se présente comme suit : projects/my-project/locations/global
Définissez le paramètre bucketId. Exemple : my-bucket.
Effectuez l'une des opérations suivantes :
- Pour créer un bucket de journaux, puis le mettre à niveau afin qu'il utilise Analyse de journaux:
  1. Définissez la valeur booléenne LogBucket.analyticsEnabled sur true.
    
    Remarque :Une fois qu'un bucket de journaux a été mis à niveau pour utiliser dans l'Analyse de journaux, vous ne pouvez pas reconfigurer le bucket de journaux modifier ou supprimer l'utilisation de l'Analyse de journaux.
  2. Appeler la méthode asynchrone projects.locations.buckets.createAsync pour créer le bucket.
    
    La réponse aux méthodes asynchrones est une objet Operation. Cet objet contient des informations sur la progression de la méthode. Lorsque la méthode l'opération est terminée, l'objet Operation contient l'état. Pour en savoir plus, consultez la page Méthodes d'API asynchrones.
    
    L'exécution de la méthode createAsync prend plusieurs minutes. Cette méthode ne génère pas de message d'erreur et échouer lorsque la valeur booléenne analyticsEnabled est définie sur true.
- Sinon, appelez la méthode synchrone projects.locations.buckets.create pour créer le bucket.

Après avoir créé un bucket, créez un récepteur pour acheminer les entrées de journal vers votre bucket et configurez les vues des journaux pour contrôler les utilisateurs autorisés à accéder aux journaux de votre nouveau bucket et les journaux qu'ils peuvent consulter. Vous pouvez aussi mettre à jour le bucket pour configurer conservation personnalisée et champs restreints.

Suivre le volume de journaux stockés dans des buckets de journaux

La page Stockage des journaux de la console Google Cloud suit le volume des stockées dans des buckets de journaux:

Dans la console Google Cloud, accédez à la page Stockage des journaux.

Accéder à la page Stockage des journaux

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

La page Stockage des journaux affiche un récapitulatif des statistiques de votre projet Google Cloud :

Les statistiques récapitulatives indiquent la quantité de données de journaux stockées dans des buckets de journaux.
pour le projet sélectionné.

Les statistiques suivantes sont consignées :

Ingestion du mois en cours: quantité de données de journaux que vos Le projet Google Cloud est stocké dans des buckets de journaux depuis le premier jour du mois calendaire en cours.
Ingestion du mois précédent : quantité de données de journaux stockées par votre projet Google Cloud dans des buckets de journaux au cours du dernier mois civil.
Ingestion prévue à la fin du mois : quantité estimée de données de journaux que votre projet Google Cloud stockera dans des buckets de journaux à la fin du mois calendaire en cours, en fonction de l'utilisation actuelle.
Stockage facturable du mois en cours : quantité de données de journaux conservées pendant plus de 30 jours et facturée.

Les statistiques précédentes n'incluent pas les journaux du bucket _Required. Les journaux de ce bucket ne peuvent pas être exclus ni désactivés.

La page Routeur de journaux de la console Google Cloud vous fournit des outils permettant de réduire les frais de stockage de journaux dans des buckets de journaux ou de stockage dépassant votre allocation mensuelle. Vous pouvez procéder comme suit :

Désactivez le stockage des journaux au niveau du bucket.
Empêcher le stockage de certaines entrées de journal dans des buckets de journaux

Pour en savoir plus, consultez la page Gérer les récepteurs.

Gérer les buckets

Cette section explique comment gérer vos buckets de journaux à l'aide de la Google Cloud CLI. ou la console Google Cloud.

Mettre à jour un bucket

Pour mettre à jour les propriétés de votre bucket, telles que description ou la durée de conservation, procédez comme suit:

console Google Cloud

Pour mettre à jour les propriétés de votre bucket, procédez comme suit:

Dans la console Google Cloud, accédez à la page Stockage des journaux.
Accéder à la page Stockage des journaux

Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.
Cliquez sur Plus pour le bucket que vous souhaitez mettre à jour.
Cliquez sur Modifier le bucket.
Modifiez votre bucket comme désiré.
Cliquez sur Mettre à jour le bucket.

gcloud

Pour mettre à jour les propriétés de votre bucket, exécutez la commande Commande gcloud logging buckets update:

gcloud logging buckets update BUCKET_ID --location=LOCATION UPDATED_ATTRIBUTES

Exemple :

gcloud logging buckets update my-bucket --location=global --description "Updated description"

REST

Pour mettre à jour les propriétés de votre bucket, utilisez projects.locations.buckets.patch dans l'API Logging.

Mettre à niveau un bucket pour utiliser l'Analyse de journaux

Pour mettre à niveau un bucket existant pour utiliser l'Analyse de journaux, les restrictions suivantes s'appliquent :

Le bucket de journaux a été créé au niveau du projet Google Cloud.
Le bucket de journaux est déverrouillé, sauf s'il s'agit du bucket _Required.
Aucune mise à jour du bucket n'est en attente.

console Google Cloud

Pour mettre à niveau un bucket existant afin d'utiliser l'Analyse de journaux, procédez comme suit:

Dans la console Google Cloud, accédez à la page Stockage des journaux.
Accéder à la page Stockage des journaux

Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.
Recherchez le bucket que vous souhaitez mettre à niveau.
Lorsque la colonne Log Analytics disponible affiche Mettre à niveau, vous pouvez mettre à niveau le bucket de journaux pour utiliser Log Analytics. Cliquez sur Mettre à niveau.

Une boîte de dialogue s'ouvre. Cliquez sur Confirmer.

gcloud

Pour mettre à niveau votre bucket de journaux afin d'utiliser l'Analyse de journaux, exécutez la gcloud logging buckets update. Vous devez définir l'indicateur --enable-analytics et nous vous recommandons d'inclure également l'indicateur --async :

gcloud logging buckets update BUCKET_ID --location=LOCATION --enable-analytics --async

L'option --async force la soit asynchrone. Le retour d'une requête asynchrone est un objet Operation, et elle contient des informations sur la progression de la méthode. Lorsque est terminée, l'objet Operation contient l'état. Pour en savoir plus, consultez la page Méthodes d'API asynchrones.

REST

Pour mettre à niveau un bucket de journaux pour utiliser l'Analyse de journaux, utilisez la méthode projects.locations.buckets.updateAsync de l'API Cloud Logging.

Préparez les arguments de la méthode comme suit :

Définissez la valeur booléenne LogBucket.analyticsEnabled sur true.
Pour le paramètre de requête de la commande, utilisez updateMask=analyticsEnabled.

La réponse aux méthodes asynchrones est une objet Operation. Cet objet contient des informations sur la progression de la méthode. Une fois la méthode terminée, l'objet Operation contient l'état. Pour plus d'informations, consultez la page Méthodes API asynchrones.

L'exécution de updateAsync peut prendre plusieurs minutes.

Créer un ensemble de données BigQuery associé

Lorsque vous souhaitez utiliser les fonctionnalités de BigQuery pour analyser vos données de journaux, mettez à niveau un bucket de journaux pour utiliser l'Analyse de journaux, puis créez un ensemble de données associé. Avec cette configuration, Logging stocke les données de journaux, BigQuery peut lire les données des journaux.

console Google Cloud

Pour créer un lien vers un ensemble de données BigQuery pour un bucket de journaux existant, procédez comme suit :

Dans la console Google Cloud, accédez à la page Stockage des journaux.
Accéder à la page Stockage des journaux

Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.
Recherchez le bucket de journaux et vérifiez que la colonne Log Analytics disponible affiche Ouvrir.

Si cette colonne affiche Mettre à niveau, cela signifie que le bucket de journaux n'a pas été pour utiliser l'Analyse de journaux. Configurez l'Analyse de journaux:
1. Cliquez sur Mettre à jour.
2. Cliquez sur Confirmer dans la boîte de dialogue.
Une fois la migration terminée, passez à l'étape suivante.
Sur le bucket de journaux, cliquez sur Plus , puis sur Modifier le bucket.

La boîte de dialogue Modifier le bucket de journaux s'ouvre.
Sélectionnez Créer un ensemble de données BigQuery associé à ce bucket, puis saisissez le nom du nouvel ensemble de données.

Le nom de l'ensemble de données doit être unique pour chaque projet Google Cloud. Si vous saisissez le nom d'un ensemble de données existant, vous obtenez l'erreur suivante: Dataset name must be unique in the selected region.
Cliquez sur OK, puis sur Mettre à jour le bucket.

Une fois que Logging affiche le nom de l'ensemble de données associé sur la page Stockage des journaux, BigQuery peut mettre plusieurs minutes à le reconnaître.

gcloud

Pour créer un ensemble de données associé à un bucket de journaux mis à niveau pour utiliser l'Analyse de journaux, exécutez la commande gcloud logging links create :

gcloud logging links create LINK_ID --bucket=BUCKET_ID --location=LOCATION

L'LINK_ID que vous fournissez est utilisé comme nom de l'ensemble de données BigQuery. La valeur de ce champ doit être unique pour votre projet Google Cloud.

La commande links create est asynchrone. Le retour d'une la méthode asynchrone est un objet Operation. contient des informations sur la progression de la méthode. Une fois la méthode terminée, l'objet Operation contient l'état. Pour plus plus d'informations, consultez la section Méthodes d'API asynchrones.

L'exécution de la commande links create prend plusieurs minutes.

Par exemple, la commande suivante crée un ensemble de données associé au bucket nommé my-bucket :

gcloud logging links create mylink --bucket=my-bucket --location=global

Le nom de l'ensemble de données doit être unique pour chaque projet Google Cloud. Si vous essayez pour créer un ensemble de données portant le même nom qu'un ensemble de données existant, recevez l'erreur suivante:

BigQuery dataset with name "LINK_ID" already exists.

Si vous tentez de créer un ensemble de données associé pour un bucket de journaux qui n'a pas été mis à niveau pour utiliser l'Analyse de journaux, l'erreur suivante s'affiche :

A link can only be created for an analytics-enabled bucket.

REST

Pour créer un ensemble de données BigQuery associé à un bucket de journaux existant mis à niveau à l'aide de l'Analyse de journaux, appelez la méthode asynchrone projects.locations.buckets.links.create de l'API Cloud Logging.

Préparez les arguments de la méthode comme suit :

Créez le corps de la requête pour la commande create. Le corps de la requête est au format d'un objet Link.
Pour le paramètre de requête de la commande, utilisez linkId=LINK_ID L'LINK_ID que vous fournissez est utilisé comme nom de l'ensemble de données BigQuery. La valeur de ce champ doit être unique pour votre projet Google Cloud.

La réponse aux méthodes asynchrones est une objet Operation. Cet objet contient des informations sur la progression de la méthode. Une fois la méthode terminée, l'objet Operation contient l'état. Pour plus plus d'informations, consultez la section Méthodes d'API asynchrones.

L'exécution de la méthode links.create prend plusieurs minutes.

Le nom de l'ensemble de données doit être unique pour chaque projet Google Cloud. Si vous essayez de créer un ensemble de données portant le même nom qu'un ensemble de données existant, l'erreur suivante s'affiche :

BigQuery dataset with name "LINK_ID" already exists.

Si vous tentez de créer un ensemble de données associé pour un bucket de journaux pour utiliser l'Analyse de journaux, l'erreur suivante est signalée:

A link can only be created for an analytics-enabled bucket.

Verrouiller un bucket

Lorsque vous verrouillez les mises à jour pour un bucket, vous verrouillez également la règle de conservation du bucket. Lorsqu'une règle de conservation est verrouillée, vous ne pouvez plus jusqu'à ce que chaque entrée de journal qu'il contient ait atteint la durée de conservation période.

Pour empêcher toute personne de mettre à jour ou de supprimer un bucket de journaux, verrouillez-le. Pour verrouiller le bucket, procédez comme suit :

console Google Cloud

La console Google Cloud ne permet pas de verrouiller un bucket de journaux.

gcloud

Pour verrouiller votre bucket, exécutez la commande gcloud logging buckets update avec l'option --locked:

gcloud logging buckets update BUCKET_ID --location=LOCATION --locked

Exemple :

gcloud logging buckets update my-bucket --location=global --locked

REST

Pour verrouiller les attributs de votre bucket, utilisez projects.locations.buckets.patch dans l'API Logging. Définissez le paramètre locked sur true.

Répertorier les buckets

Pour répertorier les buckets de journaux associés à un projet Google Cloud et afficher détails tels que les paramètres de conservation, procédez comme suit:

console Google Cloud

Dans la console Google Cloud, accédez à la page Stockage des journaux.

Accéder à la page Stockage des journaux

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

Un tableau intitulé Buckets de journaux répertorie les buckets associés au projet Google Cloud en cours.

La table répertorie les attributs suivants pour chaque bucket de journaux :

Nom: nom du bucket de journaux.
Description : description du bucket.
Durée de conservation : nombre de jours pendant lesquels les données du bucket seront stockées par Cloud Logging.
Région : emplacement géographique où les données du bucket sont stockées.
État : indique si le bucket est verrouillé ou non.

Si un bucket est en attente de suppression par Cloud Logging, son entrée de table est annotée avec un symbole d'avertissement.

gcloud

Exécutez la commande gcloud logging buckets list :

gcloud logging buckets list

Les attributs suivants s'affichent pour les buckets de journaux :

LOCATION : région dans laquelle les données du bucket sont stockées.
BUCKET_ID : nom du bucket de journaux.
RETENTION_DAYS : nombre de jours pendant lesquels les données du bucket seront stockées par Cloud Logging.
LIFECYCLE_STATE : indique si le bucket est en attente de suppression par Cloud Logging.
LOCKED : indique si le bucket est verrouillé ou non.
CREATE_TIME : horodatage indiquant la date de création du bucket.
UPDATE_TIME : horodatage indiquant la date de la dernière modification du bucket.

Vous pouvez également afficher les attributs d'un seul bucket. Par exemple, pour afficher les détails du bucket de journaux _Default dans la région global, exécutez la Commande gcloud logging buckets describe:

gcloud logging buckets describe _Default --location=global

REST

Pour répertorier les buckets de journaux associés à un projet Google Cloud, utilisez projects.locations.buckets.list dans l'API Logging.

Afficher les détails d'un bucket

Pour afficher les détails d'un seul bucket de journaux, procédez comme suit :

console Google Cloud

Dans la console Google Cloud, accédez à la page Stockage des journaux.

Accéder à la page Stockage des journaux

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

Dans le bucket de journaux, cliquez sur Plus, puis sélectionnez Afficher les détails du bucket.

La boîte de dialogue liste les attributs suivants pour le bucket de journaux:

Nom: nom du bucket de journaux.
Description : description du bucket de journaux.
Durée de conservation : nombre de jours pendant lesquels les données du bucket seront stockées par Cloud Logging.
Région : emplacement géographique où les données du bucket sont stockées.

Analyse de journaux : indique si votre bucket a été mis à niveau pour utiliser l'Analyse de journaux.
Analyse BigQuery: indique si un L'ensemble de données BigQuery est associé à votre bucket.
Ensemble de données BigQuery: fournit un lien vers votre Ensemble de données BigQuery, qui s'ouvre dans BigQuery Studio. La date à laquelle l'association à BigQuery a été activée s'affiche également.

gcloud

Exécutez la commande gcloud logging buckets describe.

Par exemple, la commande suivante indique les détails de l'_Default bucket:

gcloud logging buckets describe _Default --location=global

Les attributs suivants s'affichent pour le bucket de journaux :

createTime : horodatage indiquant la date de création du bucket.
description : description du bucket de journaux.
lifecycleState : indique si le bucket est en attente de suppression par Cloud Logging.
name : nom du bucket de journaux.
retentionDays : nombre de jours pendant lesquels les données du bucket seront stockées par Cloud Logging.
updateTime : horodatage indiquant la date de la dernière modification du bucket.

REST

Pour afficher les détails d'un seul bucket de journaux, utilisez projects.locations.buckets.get dans l'API Logging.

Supprimer un bucket

Pour supprimer un bucket de journaux, procédez comme suit :

console Google Cloud

Pour supprimer un bucket de journaux, procédez comme suit :

Dans la console Google Cloud, accédez à la page Stockage des journaux.
Accéder à la page Stockage des journaux

Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.
Recherchez le bucket que vous souhaitez supprimer, puis cliquez sur En savoir plus
Si la colonne Ensemble de données associé dans BigQuery affiche un lien, supprimez l'ensemble de données BigQuery associé :
1. Cliquez sur Modifier le bucket.
2. Décochez la case Créer un ensemble de données BigQuery associé à ce bucket, cliquez sur OK, puis sur Mettre à jour le bucket
  
  Une fois revenu sur la page Stockage des journaux, cliquez sur Plus pour le bucket que vous souhaitez supprimer, puis passez aux étapes suivantes.
Cliquez sur Supprimer le bucket.
Dans le panneau de confirmation, cliquez sur Supprimer.
Sur la page Stockage des journaux, un indicateur spécifie que votre bucket est en attente de suppression. Le bucket, y compris tous les journaux qu'il contient, est supprimé au bout de sept jours.

gcloud

Pour supprimer un bucket de journaux, exécutez la commande Commande gcloud logging buckets delete:

gcloud logging buckets delete BUCKET_ID --location=LOCATION

Vous ne pouvez pas supprimer un bucket de journaux si un bucket Ensemble de données BigQuery:

Pour répertorier les liens associés à un bucket de journaux, exécutez la commande gcloud logging links list.
Pour supprimer un ensemble de données associé, exécutez la commande gcloud logging links delete.

REST

Pour supprimer un bucket, utilisez projects.locations.buckets.delete dans l'API Logging.

Il s'agit d'une erreur de supprimer un bucket de journaux si ce bucket contient un ensemble de données BigQuery associé. Vous devez supprimer l'ensemble de données associé avant en supprimant le bucket de journaux:

Pour répertorier les liens associés à un bucket de journaux, exécutez la projects.locations.buckets.links.list .
Pour supprimer un ensemble de données associé, exécutez la projects.locations.buckets.links.delete .

Un bucket supprimé reste dans l'état "en attente de suppression" pendant sept jours et Logging continue d'acheminer des journaux vers le bucket pendant cette période. Pour arrêter l'acheminement des journaux vers un bucket supprimé, vous devez supprimer les récepteurs de journaux qui ont ce bucket en tant que destination, ou modifier le filtre des récepteurs acheminant des journaux vers ce bucket.

Vous ne pouvez pas créer de bucket de journaux portant le même nom qu'un bucket supprimé qui est en attente.

Restaurer un bucket supprimé

Vous pouvez restaurer, c'est-à-dire annuler la suppression d'un bucket de journaux dont l'état est "en attente de suppression". Pour restaurer un bucket de journaux, procédez comme suit :

console Google Cloud

Pour restaurer un bucket de journaux en attente de suppression, procédez comme suit:

Dans la console Google Cloud, accédez à la page Stockage des journaux.
Accéder à la page Stockage des journaux

Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.
Pour le bucket que vous souhaitez restaurer, cliquez sur Plus, puis sélectionnez Restaurez un bucket supprimé.
Dans le panneau de confirmation, cliquez sur Restaurer.
Sur la page Stockage des journaux, l'indicateur de suppression en attente est retiré de votre bucket de journaux.

gcloud

Pour restaurer un bucket de journaux en attente de suppression, exécutez la commande Commande gcloud logging buckets undelete:

gcloud logging buckets undelete BUCKET_ID --location=LOCATION

REST

Pour restaurer un bucket en attente de suppression, utilisez projects.locations.buckets.undelete dans l'API Logging.

Alerte sur les octets de journaux mensuels stockés dans des buckets de journaux

Pour créer une règle d'alerte, sur la page Stockage des journaux de la console Google Cloud, cliquez sur Créer une alerte d'utilisation. Ce bouton ouvre la page Créer une règle d'alerte dans Monitoring et renseigne le champ de type de métrique avec logging.googleapis.com/billing/bytes_ingested.

Pour créer une règle d'alerte qui se déclenche lorsque le nombre d'octets de journaux écrits dans vos buckets de journaux dépasse la limite définie par l'utilisateur dans Cloud Logging, utilisez les paramètres suivants.

Procédure permettant de créer une règle d'alerte

Pour créer une règle d'alerte, procédez comme suit :

Dans la console Google Cloud, accédez à la page Alertes :
Accéder à l'interface des alertes

Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Surveillance.
Si vous n'avez pas créé vos canaux de notification et que vous souhaitez être averti, cliquez sur Modifier les canaux de notification et ajoutez vos canaux de notification. Revenez à la page Alertes après avoir ajouté vos canaux.
Sur la page Alertes, cliquez sur Créer une règle.
Pour sélectionner la ressource, la métrique et les filtres, développez le menu Sélectionner une métrique, puis utilisez les valeurs du tableau Nouvelle condition :
1. (Facultatif) Pour limiter le menu aux entrées pertinentes, saisissez le nom de la ressource ou de la métrique dans la barre de filtre.
2. Sélectionner un type de ressource Par exemple, sélectionnez Instance de VM.
3. Sélectionnez une catégorie de métriques. Par exemple, sélectionnez instance.
4. Sélectionnez une métrique. Par exemple, sélectionnez Utilisation du processeur.
5. Sélectionnez Appliquer.
Cliquez sur Suivant, puis configurez le déclencheur de règle d'alerte. Pour renseigner ces champs, utilisez les valeurs du tableau Configurer le déclencheur d'alerte.
Cliquez sur Suivant.
Facultatif : Pour ajouter des notifications à votre règle d'alerte, cliquez sur Canaux de notification. Dans la boîte de dialogue, sélectionnez un ou plusieurs canaux de notification dans le menu, puis cliquez sur OK.

Pour recevoir une notification en cas d'ouverture et de fermeture d'un incident, cochez la case Notifier en cas de fermeture des incidents. Par défaut, les notifications ne sont envoyées que lorsque des incidents sont ouverts.
(Facultatif) Mettez à jour la durée de fermeture automatique de l'incident. Ce champ détermine à quel moment Monitoring ferme les incidents en l'absence de données de métriques.
Facultatif : Cliquez sur Documentation, puis ajoutez les informations à inclure dans le message de notification.
Cliquez sur Nom de l'alerte et saisissez un nom pour la règle d'alerte.
Cliquez sur Créer une règle.

ChampNouvelle condition	Valeur
Ressource et métrique	Dans le menu Ressources, sélectionnez Global. Dans le menu Catégories de métriques, sélectionnez Métrique basée sur les journaux. Dans le menu Métriques, sélectionnez Monthly log bytes ingested.
Filter	Aucun
Dans toutes les séries temporelles Agrégation de séries temporelles	`sum`
Fenêtre glissante	`60 m`
Fenêtrage glissant	`max`

Champ Configurer le déclencheur d'alerte	Valeur
Type de condition	`Threshold`
Déclencheur d'alerte	`Any time series violates`
Position du seuil	`Above threshold`
Valeur du seuil	Vous définissez la valeur acceptable.
Fenêtre du nouveau test	La valeur minimale acceptable est de 30 minutes.

Pour en savoir plus sur les règles d'alerte, consultez Vue d'ensemble des alertes

Écrire dans un bucket

Vous n'écrivez pas directement de journaux dans un bucket de journaux. Vous écrivez plutôt des journaux sur une ressource Google Cloud : un projet, un dossier ou une organisation Google Cloud. Les récepteurs de la ressource parente acheminent ensuite les journaux vers les destinations, dont les buckets de journaux. Un récepteur achemine les journaux vers une destination de bucket de journaux lorsque les journaux correspondent au filtre du récepteur et que celui-ci est autorisé à acheminer les journaux vers le bucket de journaux.

Lire des données à partir d'un bucket

Chaque bucket de journaux possède un ensemble de vues de journaux. Pour lire les journaux d'un bucket de journaux, vous devez avoir accès à une vue de journaux sur le bucket. Les vues de journaux vous permettent d'accorder à un utilisateur l'accès qu'à un sous-ensemble des journaux stockés dans un bucket de journaux. Pour savoir comment configurer des vues de journaux et accorder l'accès à des vues de journaux spécifiques, consultez Configurer des vues de journaux sur un bucket de journaux.

Pour lire les journaux d'un bucket de journaux, procédez comme suit :

console Google Cloud

Dans la console Google Cloud, accédez à la page Explorateur 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.
Pour personnaliser les journaux à afficher dans l'explorateur de journaux, Cliquez sur Affiner le champ d'application, puis sélectionnez une option. Par exemple, vous pouvez afficher les journaux stockés dans un projet ou par vue de journal.
Cliquez sur Appliquer. Le volet Résultats de la requête est actualisé avec les journaux correspondant à l'option sélectionnée.

Pour en savoir plus, consultez la section Présentation de l'explorateur de journaux : affiner le champ d'application.

gcloud

Pour lire les journaux d'un bucket de journaux, utilisez la commande gcloud logging read et ajoutez un LOG_FILTER pour sélectionner des données :

gcloud logging read LOG_FILTER --bucket=BUCKET_ID --location=LOCATION --view=VIEW_ID

REST

Pour lire les journaux d'un bucket de journaux, utilisez la méthode entries.list. Définissez resourceNames pour spécifier le bucket et la vue de journal appropriés, et définissez filter pour sélectionner les données.

Pour en savoir plus sur la syntaxe du filtrage, consultez la section Langage de requête Logging

Configurer la conservation personnalisée

Remarque : À compter du 1er avril 2023, les coûts de conservation s'appliqueront aux données de journaux conservées pendant plus longtemps que la durée de conservation par défaut du bucket _Default et des buckets de journaux définis par l'utilisateur. Pour en savoir plus sur les tarifs, consultez la synthèse des tarifs de Cloud Logging. Pour consulter l'espace de stockage facturable de vos buckets de journaux, accédez à la page Stockage des journaux de la console Google Cloud.

Lorsque vous créez un bucket de journaux, vous avez la possibilité de personnaliser la période pendant laquelle Cloud Logging stocke les journaux du bucket. Vous pouvez configurer la durée de conservation de n'importe quel bucket de journaux défini par l'utilisateur, mais aussi pour le bucket de journaux _Default.

Si vous réduisez la durée de conservation du bucket, vous bénéficiez d'un délai de grâce de sept jours dont les journaux arrivés à expiration ne sont pas supprimés. Vous ne pouvez pas interroger ni afficher ces journaux expirés mais vous pouvez restaurer l'accès complet pendant ces sept jours en étendant et la fidélisation des clients. Les journaux stockés pendant le délai de grâce sont comptabilisés dans votre les coûts de conservation.

Pour mettre à jour la durée de conservation d'un bucket de journaux, procédez comme suit :

console Google Cloud

Pour mettre à jour la durée de conservation d'un bucket de journaux, procédez comme suit :

Dans la console Google Cloud, accédez à la page Stockage des journaux.
Accéder à la page Stockage des journaux

Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.
Pour le bucket que vous souhaitez mettre à jour, cliquez sur Plus, puis sélectionnez Modifier le bucket
Dans le champ Conservation, saisissez le nombre de jours (compris entre 1 et 3 650 jours) pendant lesquels vous souhaitez que Cloud Logging conserve vos journaux.
Cliquez sur Mettre à jour le bucket. Votre nouvelle durée de conservation apparaît dans la liste Bucket de journaux.

gcloud

Pour mettre à jour la durée de conservation d'un bucket de journaux, exécutez la commande gcloud logging buckets update, après avoir défini une valeur pour RETENTION_DAYS :

gcloud logging buckets update BUCKET_ID  --location=LOCATION --retention-days=RETENTION_DAYS

Par exemple, pour conserver les journaux dans le bucket _Default dans l'emplacement global pendant un an, votre commande se présentera comme suit :

gcloud logging buckets update _Default --location=global --retention-days=365

Si vous prolongez la durée de conservation d'un bucket, les règles de conservation ne s'appliquent pas de façon rétroactive. Les journaux ne peuvent pas être récupérés après la fin de leur période de conservation spécifique.

Méthodes d'API asynchrones

La réponse d'une méthode asynchrone telle que projects.locations.buckets.createAsync est un objet Operation.

Les applications qui appellent une méthode API asynchrone doivent interroger le point de terminaison operation.get jusqu'à ce que la valeur du champ Operation.done soit true :

Lorsque l'état done est défini sur false, l'opération est en cours.

Pour actualiser les informations d'état, envoyez une requête GET au point de terminaison operation.get.
Lorsque done est défini sur true, l'opération est terminée et le champ error ou response est défini:
- error: si défini, l'opération asynchrone a échoué. La valeur de ce champ est un objet Status qui contient un code d'erreur gRPC et un message d'erreur.
- response: si défini, l'opération asynchrone est terminée et la valeur reflète le résultat.

Pour interroger une commande asynchrone à l'aide de Google Cloud CLI, exécutez la commande suivante :

gcloud logging operations describe OPERATION_ID --location=LOCATION --project=PROJECT_ID

Pour en savoir plus, consultez la page gcloud logging operations describe.

Résoudre les problèmes courants

Si vous rencontrez des problèmes lors de l'utilisation des buckets de journaux, reportez-vous aux étapes de dépannage suivantes et aux réponses aux questions courantes.

Pourquoi ne puis-je pas supprimer ce bucket ?

Si vous essayez de supprimer un bucket, procédez comme suit :

Assurez-vous de disposer des autorisations appropriées pour supprimer le bucket. Pour obtenir la liste des autorisations dont vous avez besoin, consultez la section Contrôle des accès avec IAM.
Déterminez si le bucket est verrouillé en répertoriant les attributs du bucket. Si le bucket est verrouillé, vérifiez sa durée de conservation. Vous ne pouvez pas supprimer un bucket verrouillé tant que tous les journaux qu'il contient n'ont pas atteint la date limite de conservation du bucket.

Vérifiez qu'aucun ensemble de données BigQuery n'est associé au bucket de journaux. Vous ne pouvez pas supprimer un bucket de journaux associé à un ensemble de données.

L'erreur suivante s'affiche en réponse à une commande delete sur un bucket de journaux associé à un ensemble de données :
```
FAILED_PRECONDITION: This bucket is used for advanced analytics and has an active link. The link must be deleted first before deleting the bucket
```
Pour lister les liens associés à un bucket de journaux, exécutez la commande gcloud logging links list ou la méthode API projects.locations.buckets.links.list.

Quels comptes de service acheminent les journaux vers mon bucket ?

Pour déterminer si des comptes de service disposent d'autorisations IAM pour acheminer les journaux vers votre bucket, procédez comme suit :

Dans la console Google Cloud, accédez à la page IAM :
Accéder à IAM

Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est IAM et administration.
À partir de l'onglet Autorisations, affichez la liste par Rôles. Vous voyez un tableau avec tous les rôles et comptes principaux IAM associés à votre projet Google Cloud.
Dans la tableFiltre zone de texte, saisissez Rédacteur de bucket de journaux.

Tous les comptes principaux dotés du rôle Rédacteur de bucket de journaux s'affichent. Si un compte principal est un compte de service, son ID contient la chaîne gserviceaccount.com.
Facultatif : si vous souhaitez empêcher un compte de service d'acheminer les journaux vers votre projet Google Cloud, cochez la case pour le compte de service, puis cliquez sur Supprimer.

Pourquoi des journaux d'un projet Google Cloud s'affichent-ils alors que je les ai exclus de mon récepteur `_Default` ?

Vous pouvez consulter les journaux d'un bucket de journaux projet Google Cloud centralisé, qui regroupe les journaux de toute votre organisation.

Si vous utilisez l'explorateur de journaux pour accéder à ces journaux et que vous voyez les journaux que vous avez exclus du récepteur _Default, votre vue peut être définie au niveau du projet Google Cloud.

Pour résoudre ce problème, sélectionnez Vue de journal dans le Menu Affiner le champ d'application puis sélectionnez la vue de journal associée au bucket _Default projet Google Cloud. Vous ne devriez plus voir les journaux exclus.

Étape suivante

Pour en savoir plus sur les méthodes de l'API Logs Bucket, consultez la documentation de référence sur LogBucket.

Si vous gérez une organisation ou un dossier, vous pouvez spécifier l'emplacement les buckets de journaux _Default et _Required des ressources enfants. Vous pouvez également configurer si les buckets de journaux utilisent CMEK et le comportement du collecteur de journaux _Default. Pour en savoir plus, consultez [Configurer les paramètres par défaut pour les organisations et les dossiers][default-settings].

Pour en savoir plus sur la gestion des cas d'utilisation courants des buckets de journaux, consultez les articles suivants :

[Agrégez et stockez les journaux de votre organisation][central-log-storage].

Journalisation mutualisée sur GKE.

Régionalisez vos journaux.

Configurer des buckets de journaux

Avant de commencer

Console

gcloud

REST

Créer un bucket

console Google Cloud

gcloud

REST

Suivre le volume de journaux stockés dans des buckets de journaux

Gérer les buckets

Mettre à jour un bucket

console Google Cloud

gcloud

REST

Mettre à niveau un bucket pour utiliser l'Analyse de journaux

console Google Cloud

gcloud

REST

Créer un ensemble de données BigQuery associé

console Google Cloud

gcloud

REST

Verrouiller un bucket

console Google Cloud

gcloud

REST

Répertorier les buckets

console Google Cloud

gcloud

REST

Afficher les détails d'un bucket

console Google Cloud

gcloud

REST

Supprimer un bucket

console Google Cloud

gcloud

REST

Restaurer un bucket supprimé

console Google Cloud

gcloud

REST

Alerte sur les octets de journaux mensuels stockés dans des buckets de journaux

Procédure permettant de créer une règle d'alerte

Écrire dans un bucket

Lire des données à partir d'un bucket

console Google Cloud

gcloud

REST

Configurer la conservation personnalisée

console Google Cloud

gcloud

Méthodes d'API asynchrones

Résoudre les problèmes courants

Pourquoi ne puis-je pas supprimer ce bucket ?

Quels comptes de service acheminent les journaux vers mon bucket ?

Pourquoi des journaux d'un projet Google Cloud s'affichent-ils alors que je les ai exclus de mon récepteur _Default ?

Étape suivante

Pourquoi des journaux d'un projet Google Cloud s'affichent-ils alors que je les ai exclus de mon récepteur `_Default` ?