Créer des buckets d'observabilité

Vous pouvez créer manuellement le bucket d'observabilité _Trace avant que votre projet ne reçoive des données de trace afin de personnaliser son emplacement de stockage et ses paramètres de clé de chiffrement gérée par le client (CMEK). Si votre Google Cloud projet ingère des données de trace avant que ce bucket n'existe, Google Cloud Observability le provisionne automatiquement à l'aide des paramètres par défaut de votre projet pour les buckets d'observabilité.

Pour en savoir plus sur la façon dont Google Cloud Observability stocke les données, consultez la présentation du stockage.

Interaction avec les règles d'administration

Une requête visant à créer un bucket d'observabilité vérifie que les paramètres de la commande sont conformes aux règles d'administration. Par exemple, si une règle d'administration limite les emplacements des ressources, la création d'un bucket échoue si vous spécifiez un emplacement limité.

Interaction avec les paramètres par défaut des buckets d'observabilité

Lorsque Google Cloud Observability crée automatiquement un bucket d'observabilité en raison de l'ingestion de données, il utilise les paramètres par défaut des buckets d'observabilité qui s'appliquent à la ressource parente du bucket. Ces paramètres par défaut peuvent être définis dans le parent ou dans un ancêtre hiérarchique du parent. Ils spécifient les éléments suivants :

• L'emplacement de stockage.
• La clé Cloud KMS à utiliser pour les données stockées.

Lorsque vous créez un bucket d'observabilité, vous devez spécifier un emplacement. Google Cloud Observability applique la clé Cloud KMS définie dans vos paramètres par défaut, sauf si vous spécifiez explicitement une autre clé dans votre requête de création.

Vous ne pouvez pas créer de bucket avec le chiffrement par défaut de Google si les paramètres par défaut applicables spécifient une clé Cloud KMS. Pour utiliser le chiffrement par défaut de Google, assurez-vous qu'aucune clé Cloud KMS n'est configurée dans vos paramètres par défaut.

Pour en savoir plus sur les paramètres par défaut des buckets d'observabilité, consultez Définir des valeurs par défaut pour les buckets d'observabilité.

Limites

Les restrictions suivantes s'appliquent :

• Vous devez spécifier un emplacement compatible.
• Le BUCKET_ID doit être _Trace.
• Le nom à afficher ne doit pas dépasser 100 octets encodés.
• La description ne doit pas dépasser 1 000 octets encodés.
• Les données sont stockées pendant 30 jours. Vous devez omettre la période de conservation ou la définir sur 30.
• Si vous fournissez une clé Cloud KMS, son emplacement doit correspondre exactement à l'emplacement parent du bucket d'observabilité.
• Vous ne pouvez créer des buckets d'observabilité que dans des Google Cloud projets.
• Un Google Cloud projet ne peut contenir qu'un seul bucket d'observabilité nommé _Trace.

Avant de commencer

Configurez votre projet et vos rôles IAM, puis sélectionnez l'interface que vous prévoyez d'utiliser.

Configurer votre projet et vos rôles

Connectez-vous à votre Google Cloud compte. Si vous ne connaissez pas Google Cloud, créez un compte pour évaluer les performances de nos produits dans des scénarios réels. Les nouveaux clients bénéficient également de 300 $ de crédits sans frais pour exécuter, tester et déployer des charges de travail.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

1. Pour obtenir les autorisations nécessaires pour créer des buckets d'observabilité, demandez à votre administrateur de vous accorder le rôle IAM Éditeur Observability (roles/observability.editor) dans votre projet. Pour en savoir plus sur l'attribution de rôles, consultez 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.

Configurer les interfaces

Configurer la clé Cloud KMS

Facultatif. Si vous prévoyez de créer un bucket d'observabilité et de spécifier une clé Cloud KMS, procédez comme suit :

1. Activez l'API Cloud Key Management Service.

   Rôles requis pour activer les API

   Pour activer les API, vous avez besoin de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation via le rôle Propriétaire (roles/owner). Sinon, vous pouvez obtenir cette autorisation via le rôle Administrateur d'utilisation du service (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.

   Activer l'API

2. Créez un trousseau de clés et des clés.

   L'emplacement du bucket d'observabilité doit correspondre à celui de la clé.

3. Remplacez PROJECT_ID par l'ID de votre projet, puis exécutez la commande suivante :

   gcloud beta observability settings describe \
   --location=global --project=PROJECT_ID
   

   La commande précédente vérifie si vous avez configuré un emplacement de stockage par défaut. Elle crée également le compte de service Google Cloud Observability lorsque ce compte n'existe pas. La réponse de la commande liste l'ID du compte de service.

4. Accordez le rôle Cloud KMS CryptoKey Encrypter/Decrypter au compte de service Google Cloud Observability.

   gcloud kms keys add-iam-policy-binding \
   --project=KMS_PROJECT_ID \
   --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-observability.iam.gserviceaccount.com \
   --role=roles/cloudkms.cryptoKeyEncrypterDecrypter \
   --location=KMS_KEY_LOCATION \
   --keyring=KMS_KEY_RING \
   KMS_KEY_NAME
   

   Avant d'exécuter la commande précédente, effectuez les remplacements suivants :

   • KMS_PROJECT_ID : identifiant alphanumérique unique, composé du nom de votre Google Cloud projet et d'un numéro attribué de manière aléatoire, du Google Cloud projet exécutant Cloud KMS. Pour savoir comment obtenir cet identifiant, consultez Identifier des projets.
   • service-PROJECT_NUMBER : nom du compte de service Observability qui a été listé dans la réponse de l'étape précédente.
   • KMS_KEY_LOCATION : région de la clé Cloud KMS.
   • KMS_KEY_RING : nom du trousseau de clés Cloud KMS.
   • KMS_KEY_NAME : nom de la clé Cloud KMS. Il est au format suivant : projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KEY.

Créer un bucket d'observabilité

projects/PROJECT_ID/locations/LOCATION

Lister les buckets d'observabilité

Vous pouvez lister les buckets d'observabilité pour vérifier que la requête de création a abouti.

gcloud beta observability buckets list \
 --location=LOCATION --project=PROJECT_ID

gcloud beta observability buckets list `
 --location=LOCATION --project=PROJECT_ID

gcloud beta observability buckets list ^
 --location=LOCATION --project=PROJECT_ID

---
createTime: '2026-01-21T21:39:22.381083860Z'
description: Bucket for storing spans from Cloud Trace.
name: projects/my-project/locations/us/buckets/_Trace

projects/PROJECT_ID/locations/LOCATION

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID

{
  "buckets": [
    {
      "name": "projects/my-project/locations/us/buckets/_Trace",
      "description": "Trace Bucket",
      "createTime": "2025-01-01T15:42:30.988919645Z",
      "updateTime": "2025-02-04T15:42:30.988919645Z",
      "retentionDays": 30
    }
  ]
}

Étape suivante

• Afficher et analyser la télémétrie

• Définir des valeurs par défaut pour les buckets d'observabilité : configurez un emplacement de stockage par défaut et une clé de chiffrement gérée par le client (CMEK) par défaut pour vos buckets d'observabilité.