Crea un'indagine Gemini Cloud Assist

Questa pagina mostra come creare ed esaminare le indagini di Gemini Cloud Assist.

Prima di iniziare

Verifica che nel tuo progetto siano abilitate le seguenti API:
- cloudaicompanion.googleapis.com
- cloudasset.googleapis.com
- cloudresourcemanager.googleapis.com
- geminicloudassist.googleapis.com
- (Consigliato) logging.googleapis.com
- (Consigliato) monitoring.googelapis.com
Consulta Attivazione e disattivazione dei servizi per istruzioni su come abilitare le API.
Per ottenere le autorizzazioni necessarie per creare un'indagine, chiedi all'amministratore di concederti il ruolo IAM Investigation Creator (roles/geminicloudassist.investigationCreator) sul progetto.

Questo ruolo predefinito contiene l'autorizzazione necessaria per creare un'indagine all'interno del tuo progetto. Quando crei un'indagine, ti viene concesso il ruolo IAM di proprietario dell'indagine (roles/geminicloudassist.investigationOwner) per l'indagine in questione, che ti consente di esaminarne i risultati.
Avere accesso al prodotto in esame.

Quando esegui un'indagine, Gemini Cloud Assist utilizza le tue credenziali per accedere ad API e informazioni. Ciò significa che l'accesso all'indagine è limitato a quello che hai.
Se prevedi di eseguire un'indagine su un'applicazione, questa deve essere contenuta in una cartella configurata per la gestione delle applicazioni. Gemini Cloud Assist non supporta le applicazioni create in un progetto host o in un limite di un singolo progetto.

Creare un'indagine

Console

Per creare una nuova indagine, fai clic sul pulsante Indaga associato al tuo punto di ingresso. Un punto di accesso tipico per la creazione di un'indagine è la pagina Indagini di Cloud Assist.

Vai a Indagini Cloud Assist
Espandi il menu a discesa Configura indagine.
(Facoltativo) Inserisci un nome dell'indagine per la tua indagine.

Il nome che scegli identifica questa indagine nella tua cronologia delle indagini. Se salti questo passaggio, viene generato automaticamente un nome per l'indagine.
Utilizza il menu a discesa Seleziona intervallo di tempo per selezionare l'intervallo di tempo che vuoi analizzare.

Un'ora di inizio precisa consente di effettuare correlazioni basate sul tempo tra eventi apparentemente non correlati e aggiunge più peso agli eventi che si sono verificati in prossimità dell'ora di inizio. Se non hai la certezza dell'intervallo di tempo, puoi eseguire più indagini contemporaneamente con intervalli di tempo diversi.
Descrivi il problema che stai riscontrando.

Puoi copiare e incollare il messaggio di errore esatto che hai ricevuto, utilizzare il linguaggio naturale per spiegare il problema che stai riscontrando o includere entrambi.
Se le indagini sulle applicazioni sono supportate dal tuo punto di ingresso, utilizza il campo Applicazione per scegliere un'applicazione da esaminare.
(Facoltativo) Fai clic su + Aggiungi risorsa per selezionare le risorse interessate dal problema che stai riscontrando.

Puoi aggiungere le risorse utilizzando il selettore di risorse o inserendole manualmente. Quando inserisci manualmente le risorse, devi consultare la documentazione di riferimento della risorsa per assicurarti di utilizzare il formato corretto.

Non puoi procedere con un'indagine se includi uno dei seguenti elementi:
- Risorse che si trovano in un progetto o in un'applicazione al di fuori dell'ambito dell'indagine.
- Risorse non supportate.
- Risorse non riconosciute.
Fai clic su Crea per iniziare l'indagine.

Viene visualizzata la pagina Dettagli dell'indagine e i risultati vengono visualizzati nella pagina man mano che diventano disponibili. Il completamento dell'indagine può richiedere diversi minuti. Se esci dalla pagina dei dettagli dell'indagine, puoi controllare lo stato dell'indagine facendo clic sul pulsante Notifiche ().

API

Crea un file JSON contenente le seguenti informazioni:
```
{
"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"
    ],
  },
}
```
Sostituisci quanto segue:
- INVESTIGATION_NAME: inserisci un nome per l'indagine. Ad esempio Missing Cloud Storage bucket.
- PROJECT_NAME: inserisci il nome del progetto in cui viene creata l'indagine. Ad esempio, my-project.
- ISSUE_START_TIME: inserisci la data e l'ora in cui è iniziato il problema che stai esaminando. Ad esempio, 2025-07-08T17:23:00Z.
- ISSUE_DESCRIPTION: inserisci una descrizione del problema che stai riscontrando. Puoi includere il messaggio di errore esatto che hai ricevuto, puoi utilizzare il linguaggio naturale per spiegare il problema che stai riscontrando oppure puoi includere entrambi.
- AFFECTED_RESOURCE: inserisci il nome della risorsa coinvolta nel problema che stai riscontrando. Ad esempio, //storage.googleapis.com/my-bucket. Per assicurarti di utilizzare il formato corretto per una risorsa, consulta la documentazione di riferimento della risorsa.
Per una rappresentazione completa di una risorsa di indagine, consulta la specifica della risorsa.
Ottieni un token di accesso:
```
TOKEN=$(gcloud auth print-access-token)
```
Utilizza il metodo investigations.create per creare l'indagine:
```
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"
```
Sostituisci quanto segue:
- JSON_FILE_NAME: inserisci il percorso del file JSON che hai creato in precedenza. Ad esempio, Desktop/my-investigation.json.
- PROJECT_NAME: inserisci lo stesso nome del progetto che hai incluso nell'osservazione user.project.
Nella risposta, copia il valore del parametro revision.
Utilizza il metodo investigations.revisions.run per eseguire l'indagine:
```
curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  "https://geminicloudassist.googleapis.com/v1alpha/projects/REVISION_RESOURCE:run"
```
Sostituisci REVISION_RESOURCE con il valore che hai copiato dal parametro revision.

Il completamento dell'indagine può richiedere diversi minuti. Puoi controllare lo stato dell'indagine copiando il valore del parametro name restituito nella risposta investigations.revisions.run e utilizzando il valore nel parametro name di una richiesta operations.get.

Esaminare un'indagine

Quando lavori con le indagini nella console Google Cloud , puoi visualizzare i dettagli dell'indagine dal punto di ingresso in cui l'hai avviata o dalla cronologia delle indagini del tuo progetto.

Un'indagine contiene le seguenti sezioni:

Il Riepilogo indagine

Questa sezione contiene un riepilogo di alto livello del problema, la strategia adottata da Gemini per l'indagine e i risultati chiave dell'indagine.
Le ipotesi

Questa sezione contiene una o più schede di ipotesi basate sui dati raccolti dall'indagine e sulle osservazioni effettuate. Puoi trovare i dettagli di ogni ipotesi facendo clic sul pulsante Visualizza nella scheda pertinente.
- I dettagli di un'ipotesi contengono una sezione Che cosa che descrive la natura del problema e una sezione Passaggi successivi che descrive le azioni che ti aiutano a correggere il problema o che forniscono ulteriori passaggi per la risoluzione dei problemi per confermare o confutare l'ipotesi.
  - Se è supportata una correzione per il problema identificato nell'ipotesi, nei passaggi di correzione è incluso un pulsante Genera piano. Se fai clic su Genera piano, viene creato un piano di correzione passo passo, che include azioni concrete come comandi gcloud o manifest Kubernetes. Dopo aver esaminato il piano, puoi fare clic su Esegui per eseguire le azioni descritte nel piano.
I risultati

Questa sezione contiene le osservazioni generate dall'indagine ed elenca le risorse Google Cloud coinvolte nell'indagine. Le osservazioni si basano su revisioni di runbook procedurali, log, messaggi di interruzione e avvisi.

La sezione dei risultati mostra le informazioni utilizzate da Gemini per generare le ipotesi e può essere utile per perfezionare l'indagine.

Puoi modificare l'input dell'indagine utilizzando il pulsante Modifica, che ti consente di eseguire nuovamente l'indagine con informazioni aggiornate. Quando a un'indagine sono associate più esecuzioni, puoi esaminare i risultati delle esecuzioni precedenti utilizzando il selettore a discesa Revisione.

Se disponi di un pacchetto di assistenza, puoi fare clic sul pulsante Richiedi assistenza nella pagina dei dettagli dell'indagine per aprire una richiesta di assistenza. In questo modo, puoi compilare automaticamente i dettagli della richiesta e condividere i risultati dell'indagine con il tecnico del servizio di assistenza.

Passaggi successivi

Scopri di più sulle indagini.
Visualizzare e gestire le indagini esistenti.