Créer une investigation Cloud Assist

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

Avant de commencer

  1. Vérifiez que les API suivantes sont activées pour votre projet :

    • cloudaicompanion.googleapis.com
    • cloudasset.googleapis.com
    • cloudresourcemanager.googleapis.com
    • geminicloudassist.googleapis.com
    • (Recommandé) logging.googleapis.com
    • (Recommandé) monitoring.googelapis.com

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

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

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

  4. Si vous envisagez d'effectuer une investigation sur une application, celle-ci doit être contenue dans un dossier compatible avec les applications.

Créer une investigation

Console

  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 Investigations Cloud Assist.

    Accéder à la page Investigations Cloud Assist

  2. (Facultatif) Attribuez un nom à 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.

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

  4. Sélectionnez l'heure de début du problème que vous souhaitez examiner.

  5. (Facultatif) Sélectionnez l'heure de fin lorsque le problème que vous examinez est terminé.

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

    • Pour les points d'entrée qui ne sont pas compatibles avec les investigations sur les applications, votre projet actuel est listé comme Projet cible et ne peut pas être modifié.

  7. (Facultatif) Cliquez sur + Ajouter une ressource pour sélectionner les ressources 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.

L'investigation peut prendre plusieurs minutes. Vous pouvez vérifier l'état de l'investigation 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.

Examiner une investigation

Une fois l'investigation terminée, vous pouvez en afficher les détails à partir du point d'entrée où vous l'avez lancée ou dans l'historique des investigations de votre projet.

Une investigation contient les sections suivantes :

  1. Description du problème

    Cette section contient les informations d'entrée utilisées pour générer les résultats de l'investigation, telles que la description du problème, les codes temporels et les listes de ressources pertinentes. Trois types de listes de ressources peuvent être associés à l'investigation :

    • Ressources fournies par l'utilisateur : les ressources qui ont été fournies par l'utilisateur ou récupérées à partir de l'erreur initiale.
    • Ressources détectées : les ressources supplémentaires prises en compte par Gemini lors de l'investigation.
    • Ressources pertinentes : les ressources identifiées par Gemini comme étant en lien avec l’hypothèse de cause, incluant systématiquement les ressources fournies par l’utilisateur.

  2. Observations

    Cette section contient les observations générées par 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. À partir de ces observations, Gemini génère des hypothèses sur la cause du problème qui fait l'objet d'une investigation.

  3. Hypothèses

    Cette section contient une ou plusieurs hypothèses fondées sur les données collectées et les observations réalisées au cours de l'investigation. Une hypothèse contient un aperçu du problème potentiel et des correctifs recommandés, qui sont des 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.

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.

Étapes suivantes