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

Gérer les buckets de journaux

Cette page explique comment créer et gérer des buckets de journaux.

Les buckets de journaux sont des conteneurs de stockage Cloud Logging dans vos projets Google Cloud dans lesquels sont stockés les données de vos journaux. Vous pouvez créer des récepteurs de journaux pour tout acheminer, ou seulement un sous-ensemble, de vos journaux vers un bucket de journaux. Cette flexibilité vous permet de choisir le projet Cloud dans lequel vos journaux sont stockés et les autres journaux stockés.

De leur nom, les buckets de journaux peuvent ressembler à des buckets Cloud Storage, mais les buckets de journaux constituent une fonctionnalité de l'espace de stockage Cloud Logging. Contrairement aux données de journaux stockées dans Cloud Storage, les journaux que vous stockez dans Cloud Logging sont indexés, optimisés et distribués pour vous permettre d'analyser vos journaux en temps réel.

Présentation

Pour chaque projet Cloud, Logging crée automatiquement deux buckets de journaux: _Required et _Default. Tous les journaux générés dans le projet sont stockés dans les buckets de journaux _Required et _Default de ce projet. Ils résident dans le projet dans lequel ils sont générés. La section suivante décrit le rôle et l'objectif des buckets _Required et _Default :

  • _Required : ce bucket contient les journaux d'audit des activités d'administration, les journaux d'audit des événements système et les journaux Access Transparency, et les conserve pendant 400 jours. Les journaux stockés dans _Required ne vous sont pas facturés, et leur durée de conservation ne peut pas être modifiée. Vous ne pouvez pas supprimer ce bucket.

  • _Default : ce bucket contient tous les autres journaux ingérés dans un projet Google Cloud, à l'exception de ceux du bucket _Required. La tarification Cloud Logging standard s'applique à ces journaux. Les entrées de journal du bucket _Default sont conservées pendant 30 jours, sauf si vous appliquez des règles de conservation personnalisées. Vous ne pouvez pas supprimer ce bucket, mais vous pouvez désactiver le récepteur de journaux _Default qui achemine les journaux vers ce bucket.

Pour ces buckets, Logging crée automatiquement des récepteurs de journaux nommés _Required et _Default qui acheminent les journaux vers les buckets correspondants.

Les buckets de journaux ne disposent que d'une disponibilité régionale, y compris ceux créés dans la région global. Si location est défini sur global, Logging ne spécifie pas l'emplacement physique dans lequel les journaux sont stockés.

Logging crée également des vues par défaut qui permettent d'accéder aux journaux d'un bucket :

  • La vue _AllLogs est disponible pour tous les buckets et affiche tous les journaux qu'ils contiennent.

  • La vue _Default n'est disponible que pour le bucket _Default et affiche tous les journaux, à l'exception des journaux d'audit pour l'accès aux données.

Pour en savoir plus sur la manière dont Cloud Logging achemine et stocke les données de vos journaux, consultez la présentation du routeur de journaux. Pour en savoir plus sur les méthodes d'API du bucket de journaux, reportez-vous à la documentation de référence sur LogBucket.

Limites

Bien que les buckets de journaux soient accessibles à tous, les autres fonctionnalités ne sont disponibles que dans les phases d'aperçu. Tenez compte des limites suivantes :

Gérer les buckets

L'outil de ligne de commande gcloud et Google Cloud Console vous permettent de créer, de mettre à jour et de supprimer vos buckets de journaux personnalisés.

Créer un bucket de journaux

Pour créer un bucket de journaux personnalisé pour votre projet, suivez la procédure ci-dessous. Vous pouvez créer au maximum 10 buckets par projet.

gcloud

Pour créer un bucket dans votre projet, exécutez la commande gcloud logging buckets create:

gcloud logging buckets create BUCKET_ID --location=LOCATION OPTIONAL_FLAGS

Exemple :

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

Console

Pour créer un bucket dans votre projet, procédez comme suit :

  1. Dans le menu "Journalisation", sélectionnez Stockage des journaux.

    Accéder à la page "Stockage des journaux"

  2. Cliquez sur Créer un bucket de journaux.

  3. Saisissez un Nom et une Description pour votre bucket.

  4. Vous pouvez également définir une période de conservation personnalisée ou la région du bucket en cliquant sur Suivant.

  5. 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.

  6. Sélectionnez la région de votre bucket en cliquant sur le menu déroulant Sélectionner la région du bucket de journaux et en sélectionnant la région dans laquelle vous souhaitez ajouter votre bucket.

  7. Cliquez sur Créer un bucket. Votre nouveau bucket s'affiche dans la liste Bucket de journaux.

Après avoir créé un bucket, vous pouvez configurer 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.

Mettre à jour un bucket de journaux

Pour mettre à jour les attributs de votre bucket, procédez comme suit :

gcloud

Pour mettre à jour les attributs de votre bucket, exécutez la 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"

Console

Pour mettre à jour les attributs de votre bucket, procédez comme suit :

  1. Dans le menu "Journalisation", sélectionnez Stockage des journaux.

    Accéder à la page "Stockage des journaux"

  2. Cliquez sur l'élément Plus correspondant au bucket que vous souhaitez mettre à jour.

  3. Cliquez sur Modifier le bucket.

  4. Modifiez votre bucket comme désiré.

  5. Cliquez sur Mettre à jour le bucket.

Verrouiller un bucket de journaux

Vous pouvez verrouiller un bucket pour empêcher toute personne de le mettre à jour ou de le supprimer immédiatement. Pour verrouiller un bucket, procédez comme suit :

GCLOUD

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

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

Exemple :

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

Afficher les détails des buckets de journaux

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

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 donné au bucket lors de sa création.
  • 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 déverrouillé.
  • CREATE_TIME: horodatage indiquant la date de création du bucket.
  • UPDATE_TIME: horodatage indiquant la date de 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, exécutez la commande gcloud logging buckets describe:

gcloud logging buckets describe _Default --location=global

Console

Accédez à la page Stockage des journaux:

Accéder à la page "Stockage des journaux"

Vous voyez un tableau Buckets de journaux qui répertorie les buckets associés au projet Cloud actuel.

Le tableau répertorie les attributs suivants pour chaque bucket de journaux:

  • Nom: le nom attribué au bucket lors de sa création.
  • Description: description attribuée au bucket lors de sa création.
  • Durée de conservation: nombre de jours pendant lesquels les données du bucket seront stockées par Cloud Logging.
  • Region (Région) : emplacement géographique où les données du bucket sont stockées.
  • État: indique si le bucket est verrouillé ou déverrouillé.

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

Supprimer un bucket de journaux

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

gcloud

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

gcloud logging buckets delete BUCKET_ID --location=LOCATION

Console

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

  1. Dans le menu "Journalisation", sélectionnez Stockage des journaux.

    Accéder à la page "Stockage des journaux"

  2. Cliquez sur l'élément Plus correspondant au bucket que vous souhaitez supprimer.

  3. Cliquez sur Supprimer le bucket.

  4. Dans le panneau de confirmation, cliquez sur Supprimer.

  5. 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.

Restaurer un bucket de journaux supprimé

Vous pouvez restaurer, c'est-à-dire annuler la suppression d'un bucket dont l'état est "en attente de suppression".

GCLOUD

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

gcloud logging buckets undelete BUCKET_ID --location=LOCATION

CONSOLE

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

  1. Dans le menu "Journalisation", sélectionnez Stockage des journaux.

    Accéder à la page "Stockage des journaux"

  2. Cliquez sur l'élément Plus correspondant au bucket que vous souhaitez restaurer.

  3. Cliquez sur Restaurer un bucket supprimé.

  4. Dans le panneau de confirmation, cliquez sur Restaurer.

  5. Sur la page Stockage des journaux, l'indicateur de suppression en attente est retiré de votre bucket.

Dépannage et questions fréquentes

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

Pourquoi les journaux d'un projet apparaissent-ils alors que je les ai exclus de mon récepteur _Default ?

Si vous accédez aux journaux d'un projet centralisé et que vous voyez les journaux que vous avez exclus du récepteur _Default, vous pouvez voir les journaux selon l'une des conditions suivantes :

  • Afficher les journaux à l'aide de l'ancienne visionneuse de journaux, qui ne permet pas d'afficher les journaux centralisés.

  • Afficher les journaux à l'aide de l'explorateur de journaux avec l'option Recherche par projet sélectionnée dans le panneau Affiner le champ d'application, qui affiche les journaux générés par le projet, quel que soit l'endroit où vous les stockez.

Pour vérifier que vous avez bien exclu les journaux, cliquez sur Recherche par espace de stockage dans le panneau Affiner le champ d'application de l'explorateur de journaux, puis sélectionnez le bucket _Default dans votre projet. Vous ne devriez plus voir les journaux exclus.

Pourquoi ne puis-je pas créer de métriques basées sur les journaux dans le bucket de journaux ?

Vous ne pouvez pas créer de métriques basées sur les journaux pour les buckets de journaux. Ces métriques ne s'appliquent qu'à un seul projet Cloud.

Étape suivante

Pour en savoir plus sur les cas d'utilisation courants des buckets de journaux, consultez la documentation suivante: