Créer une investigation Cloud Assist

Cette page vous explique comment créer et examiner des investigations Gemini Cloud Assist à l'aide de la console Google Cloud .

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 App Hub.

Créer une investigation

  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. Sélectionnez l'heure de début du problème que vous souhaitez examiner.

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

  5. Examinez le projet ou l'application sur lesquels l'investigation sera axée.

    • Si l'investigation est créée dans un projet, celui-ci est sélectionné et ne peut pas être modifié.

    • Si l'investigation est créée dans un dossier compatible avec les applications, une application App Hub peut être sélectionnée.

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

  7. Dans la section Ressources de projet pertinentes, sélectionnez les ressources concernées par le problème que vous rencontrez. Si vous incluez des informations dans le champ Message d'erreur, l'ajout de ressources pertinentes est facultatif, mais toujours recommandé.

    Vous pouvez ajouter des ressources en utilisant l'outil de sélection de ressources ou en les entrant manuellement selon la structure suivante :

    //API_NAME/projects/PROJECT/locations/LOCATION/resource/RESOURCE

    Notez que l'investigation échoue 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'enquête.
    • 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 ().

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.

Étapes suivantes