Créer une investigation Gemini Cloud Assist

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 ou une limite de projet unique.

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 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 à 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 plage de dates, vous pouvez exécuter simultanément plusieurs investigations avec des plages de dates 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 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 sur l'investigation, vous pouvez vérifier son état en cliquant sur le bouton Notifications ().

Examiner une investigation

Lorsque vous travaillez sur des investigations dans la console Google Cloud , 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. 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 principales conclusions de l'enquête.

  2. 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 en savoir plus sur chaque hypothèse, cliquez sur le bouton Afficher de la fiche 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 possible pour le problème identifié dans l'hypothèse, un bouton Générer un plan est inclus dans les étapes de correction. En cliquant sur Générer un plan, vous créez 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 ressources Google Cloud 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 "Résultats" indique les informations utilisées par Gemini pour générer les hypothèses. Elle peut vous aider à affiner votre enquête.

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 d'informations 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'enquête avec l'ingénieur de l'assistance'assistance.

Étapes suivantes