Crea un'indagine Gemini Cloud Assist

Google Cloud

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

Prima di iniziare

Verifica di aver configurato Gemini Cloud Assist.
(Facoltativo) Verifica di aver abilitato le API consigliate:
- logging.googleapis.com
- monitoring.googelapis.com
- cloudresourcemanager.googleapis.com
Per istruzioni su come abilitare le API, consulta Abilitare e disabilitare i servizi.
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 progetto. Quando crei un'indagine, ti viene concesso il ruolo IAM Investigation Owner (roles/geminicloudassist.investigationOwner) per quell'indagine, che ti consente di esaminarne i risultati.
Avere accesso al prodotto oggetto dell'indagine.

Quando esegui un'indagine, Gemini Cloud Assist utilizza le tue credenziali per accedere alle API e alle informazioni. Ciò significa che l'accesso all'indagine è limitato all'accesso di cui disponi.
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 punto di ingresso. Un punto di ingresso tipico per la creazione di un'indagine è la pagina Indagini di Cloud Assist.

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

Il nome scelto identifica questa indagine nella 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 esaminare.

Un'ora di inizio precisa consente di effettuare correlazioni basate sul tempo tra eventi apparentemente non correlati e di dare maggiore importanza agli eventi che si sono verificati in prossimità dell'ora di inizio. Se non sei sicuro 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 che sono interessate dal problema che stai riscontrando.

Puoi aggiungere le risorse utilizzando il selettore di risorse o inserendole manualmente. Quando inserisci le risorse manualmente, consulta 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 avviare l'indagine.

Si apre 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, utilizzare il linguaggio naturale per spiegare il problema che stai riscontrando o 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 investigations.create metodo 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 investigations.revisions.run metodo 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 name parametro restituito nella risposta investigations.revisions.rune utilizzando il valore nel parametro namedi una richiesta operations.get.

Esaminare un'indagine

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

Un'indagine contiene le seguenti sezioni:

Il riepilogo dell'indagine

Questa sezione contiene un riepilogo di alto livello del problema, della strategia adottata da Gemini per l'indagine e dei 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 il possibile problema e una sezione Passaggi successivi che descrive le azioni che ti aiutano a correggere il problema o che ti forniscono passaggi di risoluzione dei problemi aggiuntivi 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 e elenca le Google Cloud risorse 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 rivedere l'input dell'indagine utilizzando il pulsante Modifica, che ti consente di eseguire di nuovo l'indagine con informazioni aggiornate. Quando a un'indagine sono associate più esecuzioni, puoi esaminare i risultati delle esecuzioni precedenti dell'indagine 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.
Visualizza e gestisci le indagini esistenti.