Créer une investigation Gemini Cloud Assist

Important : À compter du 10 avril 2026, la création, l'exécution et la modification des investigations ne seront disponibles que pour les utilisateurs disposant d'un contrat d'assistance Premium ou ayant demandé l'accès par l'intermédiaire de leur équipe chargée du compte. Si vous avez exécuté une investigation avant le 10 avril 2026, ses résultats resteront disponibles dans la Google Cloud console.

L'utilisation de cette offre en version preview de Gemini Cloud Assist est soumise au Contrat Google Cloud , y compris aux Conditions des offres de pré-DG des Google Cloud Conditions spécifiques du service, ainsi qu'aux conditions du Programme Testeur de confiance de Google Cloud Gemini pour.

Cette page vous explique comment créer et examiner des investigations Gemini Cloud Assist.

Avant de commencer

1. Vérifiez que vous avez configuré Gemini Cloud Assist.

2. (Facultatif) Vérifiez que vous avez activé les API recommandées :

   • logging.googleapis.com
   • monitoring.googelapis.com
   • cloudresourcemanager.googleapis.com

   Pour découvrir comment activer des API, consultez Activer et désactiver des services.

3. Pour obtenir les autorisations requises pour créer une investigation, demandez à votre administrateur de vous accorder le rôle IAM Créateur d'investigations (roles/geminicloudassist.investigationCreator) sur le projet.

   Ce rôle prédéfini contient l'autorisation qui est requise pour créer une investigation dans votre projet. Lorsque vous créez une investigation, le rôle IAM Propriétaire d'investigation (roles/geminicloudassist.investigationOwner) vous est attribué pour cette investigation, ce qui vous permet d'examiner ses résultats.

4. Obtenez l'accès au produit qui fait l'objet d'une investigation.

   Lorsque vous effectuez une investigation, Gemini Cloud Assist utilise vos identifiants pour accéder aux API et aux informations. Par conséquent, l’étendue de l’investigation dépend des autorisations dont vous disposez.

5. Si vous envisagez d'effectuer une investigation sur une application, celle-ci doit être contenue dans un dossier configuré pour la gestion des applications. Gemini Cloud Assist n'est pas compatible avec les applications créées dans un projet hôte ni avec une limite de projet unique.

Créer une investigation

Console

Important : La fonctionnalité Investigations est intégrée à plusieurs services et workflowsGoogle Cloud . Il est possible que votre expérience de création d'une investigation diffère légèrement de celle décrite dans ce document. Par exemple, certains services peuvent saisir automatiquement des informations telles que l'heure de début ou le champ permettant de décrire le problème.

1. Pour créer une investigation, cliquez sur le bouton Examiner associé à votre point d'entrée. Le point d'entrée habituel pour créer une investigation est la page Cloud Assist Investigations.

   Accéder à la page Cloud Assist Investigations

2. Développez le menu déroulant Configurer l'investigation.

3. (Facultatif) Attribuez un nom d'investigation à votre investigation.

   Le nom que vous choisissez permet d'identifier cette investigation dans votre historique des investigations. Si vous ignorez cette étape, un nom sera généré automatiquement pour l'investigation.

4. Utilisez le menu déroulant Sélectionner une période pour sélectionner la période que vous souhaitez examiner.

   Une heure de début précise permet d'établir des corrélations temporelles entre des événements apparemment sans lien, et de mettre en évidence des événements qui se sont produits à proximité de cette heure. Si vous n'êtes pas sûr de la période, vous pouvez exécuter plusieurs investigations simultanément avec des périodes différentes.

5. Décrivez le problème que vous rencontrez.

   Vous pouvez copier et coller le message d'erreur exact que vous avez reçu, décrire le problème en langage naturel ou faire les deux.

6. Si les investigations sur les applications sont compatibles avec votre point d'entrée, utilisez le champ Application pour choisir une application à examiner.

7. (Facultatif) Cliquez sur + Ajouter une ressource pour sélectionner les ressources qui sont concernées par le problème que vous rencontrez.

   Vous pouvez ajouter des ressources en utilisant l'outil de sélection de ressources ou en les saisissant manuellement. Lorsque vous saisissez des ressources manuellement, vous devez consulter la documentation de référence de la ressource pour vous assurer d'utiliser le bon format.

   Vous ne pouvez pas effectuer une investigation si vous incluez l'un des types de ressources suivants :

   • Ressources qui se trouvent dans un projet ou une application en dehors du champ d'application de l'investigation.
   • Ressources non acceptées
   • Ressources non reconnues.

8. Cliquez sur Créer pour commencer l'investigation.

La page Détails de l'investigation s'ouvre et les résultats s'affichent au fur et à mesure qu'ils sont disponibles. L'investigation peut prendre plusieurs minutes. Si vous quittez la page d'informations de l'investigation, vous pouvez vérifier son état en cliquant sur le bouton Notifications ().

API

1. Créez un fichier JSON contenant les informations suivantes :

   {
   "title": "INVESTIGATION_NAME",
   "observations": {
     "user.project": {
       "id": "user.project",
       "observationType": "OBSERVATION_TYPE_STRUCTURED_INPUT",
       "observerType": "OBSERVER_TYPE_USER",
       "text": "PROJECT_NAME"
     },
     "user.input.text": {
       "id": "user.input.text",
       "observationType": "OBSERVATION_TYPE_TEXT_DESCRIPTION",
       "observerType": "OBSERVER_TYPE_USER",
       "timeIntervals": [
         {
           "startTime": "ISSUE_START_TIME"
         }
       ],
       "text": "ISSUE_DESCRIPTION",
       "relevantResources": [
         "AFFECTED_RESOURCE"
       ],
     },
   }
   

   Remplacez les éléments suivants :

   • INVESTIGATION_NAME : saisissez le nom de l'investigation. Exemple : Missing Cloud Storage bucket.

   • PROJECT_NAME : saisissez le nom du projet dans lequel l'investigation est créée. Par exemple, my-project.

   • ISSUE_START_TIME : saisissez la date et l'heure de début du problème que vous souhaitez examiner. Exemple : 2025-07-08T17:23:00Z.

   • ISSUE_DESCRIPTION : saisissez une description du problème que vous rencontrez. Vous pouvez inclure le message d'erreur exact que vous avez reçu, décrire le problème en langage naturel ou faire les deux.

   • AFFECTED_RESOURCE : saisissez le nom de la ressource concernée par le problème que vous rencontrez. Exemple : //storage.googleapis.com/my-bucket. Consultez la documentation de référence de la ressource pour vous assurer d'utiliser le bon format.

   Pour obtenir une représentation complète d'une ressource d'investigation, consultez la spécification de la ressource.

2. Obtenez un jeton d'accès :

   TOKEN=$(gcloud auth print-access-token)

3. Utilisez la méthode investigations.create pour créer le l'investigation :

   curl -X POST --data-binary @JSON_FILE_NAME \
     -H "Authorization: Bearer $TOKEN" \
     -H 'Content-Type: application/json' \
     "https://geminicloudassist.googleapis.com/v1alpha/projects/PROJECT_NAME/locations/global/investigations"
   

   Remplacez les éléments suivants :

   • JSON_FILE_NAME : saisissez le chemin d'accès au fichier JSON que vous avez créé précédemment. Exemple : Desktop/my-investigation.json.

   • PROJECT_NAME : saisissez le même nom de projet que celui que vous avez inclus dans l'observation user.project.

4. Dans la réponse, copiez la valeur du paramètre revision.

5. Utilisez la méthode investigations.revisions.run pour exécuter l'investigation :

   curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     "https://geminicloudassist.googleapis.com/v1alpha/projects/REVISION_RESOURCE:run"
   

   Remplacez REVISION_RESOURCE par la valeur que vous avez copiée à partir du paramètre revision.

L'investigation peut prendre plusieurs minutes. Vous pouvez vérifier l'état de l'investigation en copiant la valeur du paramètre name renvoyé dans la réponse investigations.revisions.run et en utilisant cette valeur dans le paramètre name d'une requête operations.get.

Remarque : L'utilisateur ou le compte de service qui crée une investigation se voit attribuer le rôle IAM Propriétaire d'investigation (roles/geminicloudassist.investigationOwner) pour cette investigation spécifique lors de la création.

Examiner une investigation

Lorsque vous utilisez des investigations dans la Google Cloud console, vous pouvez afficher les détails de l'investigation à partir du point d'entrée où vous l'avez lancée ou dans l' historique des investigationsde votre projet.

Une investigation contient les sections suivantes :

1. Le récapitulatif de l'investigation

   Cette section contient un résumé général du problème, de la stratégie adoptée par Gemini pour l'examiner et des principaux résultats de l'investigation.

2. Les hypothèses

   Cette section contient une ou plusieurs cartes d'hypothèses basées sur les données collectées et les observations réalisées au cours de l'investigation. Pour afficher les détails de chaque hypothèse, cliquez sur le bouton Afficher de la carte correspondante.

   • Les détails d'une hypothèse contiennent une section Quoi décrivant le problème potentiel et une section Étapes suivantes décrivant les actions qui vous aident à corriger le problème ou qui vous fournissent des étapes de dépannage supplémentaires pour confirmer ou réfuter l'hypothèse.

     • Si une correction est compatible avec le problème identifié dans l'hypothèse, un bouton Générer un plan est inclus dans les étapes de correction. Cliquez sur Générer un plan pour créer un plan de correction détaillé, qui inclut des actions concrètes telles que des commandes gcloud ou des manifestes Kubernetes. Après avoir examiné le plan, vous pouvez cliquer sur Exécuter pour effectuer les actions décrites dans le plan.

3. Les résultats

   Cette section contient les observations générées par l'investigation et liste les Google Cloud ressources impliquées dans l'investigation. Les observations sont basées sur l'examen des runbooks de procédures, des journaux, des messages d'indisponibilité ainsi que des alertes.

   La section des résultats vous indique les informations utilisées par Gemini pour générer les hypothèses et peut vous aider à affiner votre investigation.

Vous pouvez modifier l'entrée de votre investigation à l'aide du bouton Modifier, qui vous permet d'exécuter de nouveau l'investigation avec des informations mises à jour. Lorsqu'une investigation est associée à plusieurs exécutions, vous pouvez examiner les résultats des exécutions précédentes à l'aide du sélecteur de menu déroulant Révision.

Si vous disposez d'une formule d'assistance, vous pouvez cliquer sur le bouton Demander de l'aide sur la page de détails de l'investigation pour envoyer une demande d' assistance. Vous pouvez alors renseigner automatiquement les détails de la demande et partager les résultats de l'investigation avec l'ingénieur de l'assistance.

Étape suivante

• En savoir plus sur les investigations
• Affichez et gérez les investigations existantes.