REST Resource: projects.locations.investigations

Risorsa: Indagine

Contiene i contenuti di un'indagine di risoluzione dei problemi di Gemini Cloud Assist.

Rappresentazione JSON 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "revision": string,
  "revisionIndex": integer,
  "revisionPredecessor": string,
  "annotations": {
    object (InvestigationAnnotations)
  },
  "executionState": enum (InvestigationExecutionState),
  "error": {
    object (Status)
  },
  "operation": string,
  "title": string,
  "observations": {
    string: {
      object (Observation)
    },
    ...
  },
  "observerStatuses": {
    string: {
      object (ObserverStatus)
    },
    ...
  }
}
Campi
name

string

Identificatore. Nome dell'indagine, nel formato: projects/{projectNumber}/locations/{locationId}/investigations/{investigationId}
createTime

string (Timestamp format)

Solo output. L'ora in cui è stata creata l'indagine.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. L'ora dell'ultimo aggiornamento dell'indagine.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Facoltativo. Etichette definite dall'utente per l'indagine.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
revision

string

Solo output. Nome risorsa della revisione corrente dell'indagine, nel formato: projects/{projectNumber}/locations/{locationId}/investigations/{investigationId}/revisions/{revision_id}
revisionIndex

integer

Solo output. Indice della revisione corrente dell'indagine.
revisionPredecessor

string

Facoltativo. Il nome della revisione precedente a questa.
annotations

object (InvestigationAnnotations)

Facoltativo. Annotazioni aggiuntive sull'indagine.
executionState

enum (InvestigationExecutionState)

Solo output. Lo stato di esecuzione dell'indagine.
error

object (Status)

Solo output. L'errore se l'esecuzione dell'indagine non è riuscita. Questo campo verrà impostato solo se executionState è INVESTIGATION_EXECUTION_STATE_FAILED.
operation

string

Solo output. Il nome della risorsa dell'operazione di esecuzione eseguita più di recente sull'indagine, nel formato: projects/{projectNumber}/locations/{locationId}/operations/{operation_id}
title

string

Facoltativo. Titolo visualizzato leggibile per l'indagine.
observations

map (key: string, value: object (Observation))

Facoltativo. Osservazioni sullo stato del progetto che costituiscono il contenuto dell'indagine.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
observerStatuses

map (key: string, value: object (ObserverStatus))

Facoltativo. Stati degli osservatori che sono stati richiamati per eseguire l'indagine.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

InvestigationAnnotations

Annotazioni aggiuntive in un'indagine.

Rappresentazione JSON 
{
  "supportCase": string,
  "revisionLastRunInterval": {
    object (Interval)
  },
  "pagePath": string,
  "extrasMap": {
    string: string,
    ...
  }
}
Campi
supportCase

string

Facoltativo. Un case ID di assistenza associato all'indagine.
revisionLastRunInterval

object (Interval)

Solo output. L'intervallo durante il quale è stata eseguita l'ultima indagine.
pagePath

string

Facoltativo. Il percorso di una pagina web da cui è stata creata questa indagine.
extrasMap

map (key: string, value: string)

Facoltativo. Annotazioni aggiuntive specificate dal cliente.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Intervallo

Rappresenta un intervallo di tempo, codificato come Timestamp di inizio (incluso) e Timestamp di fine (escluso).

L'inizio deve essere inferiore o uguale alla fine. Quando l'inizio è uguale alla fine, l'intervallo è vuoto (non corrisponde a nessun orario). Se non vengono specificati né l'inizio né la fine, l'intervallo corrisponde a qualsiasi ora.

Rappresentazione JSON 
{
  "startTime": string,
  "endTime": string
}
Campi
startTime

string (Timestamp format)

Facoltativo. Inizio inclusivo dell'intervallo.

Se specificato, un timestamp corrispondente a questo intervallo dovrà essere uguale o successivo all'inizio.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Facoltativo. Fine esclusiva dell'intervallo.

Se specificato, un timestamp corrispondente a questo intervallo dovrà essere precedente alla fine.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

InvestigationExecutionState

Lo stato di esecuzione di un'indagine.

Enum
INVESTIGATION_EXECUTION_STATE_UNSPECIFIED Valore predefinito. Questo valore non viene utilizzato.
INVESTIGATION_EXECUTION_STATE_RUNNING L'indagine è in corso.
INVESTIGATION_EXECUTION_STATE_MODIFIED L'indagine non è ancora stata eseguita dall'ultimo aggiornamento.
INVESTIGATION_EXECUTION_STATE_FAILED L'esecuzione dell'indagine è stata completata, ma non è riuscita.
INVESTIGATION_EXECUTION_STATE_COMPLETED Tutte le attività di esecuzione sono state completate e l'indagine è terminata.

Osservazione

Un'osservazione rappresenta un singolo fatto sullo stato del sistema in esame, insieme a una classificazione della sua pertinenza.

Rappresentazione JSON 
{
  "id": string,
  "timeIntervals": [
    {
      object (Interval)
    }
  ],
  "title": string,
  "observationType": enum (ObservationType),
  "observerType": enum (ObserverType),
  "text": string,
  "data": {
    object
  },
  "dataUrls": {
    string: string,
    ...
  },
  "knowledgeUrls": {
    string: string,
    ...
  },
  "baseObservations": [
    string
  ],
  "relevantResources": [
    string
  ],
  "recommendation": string,
  "systemRelevanceScore": number,
  "relevanceOverride": enum (UserRelevance),
  "observationCompletionState": enum (ObservationCompletionState),
  "observedNormalOperation": boolean
}
Campi
id

string

Solo output. Identifica in modo univoco questa osservazione. È sempre uguale alla chiave della mappa di questa osservazione nell'indagine principale.
timeIntervals[]

object (Interval)

Facoltativo. Quando si è verificata questa osservazione.
title

string

Facoltativo. Titolo di visualizzazione leggibile per l'osservazione.
observationType

enum (ObservationType)

Obbligatorio. Il tipo di osservazione.
observerType

enum (ObserverType)

Obbligatorio. Il tipo di osservatore che ha prodotto questa osservazione.
text

string

Facoltativo. Testo in linguaggio naturale o markdown che spiega l'osservazione.
data

object (Struct format)

Facoltativo. Una rappresentazione strutturata dell'osservazione. Non è obbligatorio o garantito che sia conforme a uno schema particolare.
dataUrls

map (key: string, value: string)

Facoltativo. URL che rimandano a prove a supporto di questa osservazione. Mappa da una descrizione leggibile a un URL.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
knowledgeUrls

map (key: string, value: string)

Facoltativo. URL che rimandano a conoscenze di riferimento correlate a questa osservazione. Mappa da una descrizione leggibile a un URL.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
baseObservations[]

string

Facoltativo. Gli ID di altre osservazioni su cui si basa questa osservazione. Ad esempio, un'osservazione dell'ipotesi registrerà le osservazioni che supportano l'ipotesi.
relevantResources[]

string

Facoltativo. Le risorse Google Cloud pertinenti per l'osservazione. Questi devono essere URI risorsa completi, ad esempio: "//compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-instance"
recommendation

string

Facoltativo. Testo in linguaggio naturale o Markdown che descrive un'azione consigliata per risolvere la causa principale o approfondire l'indagine sul problema.
systemRelevanceScore

number

Facoltativo. Il livello di pertinenza percepito dall'osservatore. Viene utilizzato per classificare le osservazioni nella generazione di ipotesi. Il sistema restituisce osservazioni nell'intervallo [-1, 1], dove -1 significa completamente irrilevante, 0 significa neutro e 1 significa confidenza completa nella sua pertinenza.
relevanceOverride

enum (UserRelevance)

Facoltativo. Il giudizio di pertinenza dell'utente.
observationCompletionState

enum (ObservationCompletionState)

Facoltativo. Indica se l'osservazione è completamente formata e può essere utilizzata per trarre conclusioni.
observedNormalOperation

boolean

Facoltativo. Se è falso o non specificato, questa osservazione fornisce informazioni su un problema o una causa principale. Se è true, questa osservazione indica che è stato osservato che un sistema funziona normalmente. Questi risultati negativi possono essere utili per la diagnostica e questo campo non ha alcuna correlazione con il punteggio di pertinenza.

ObservationType

Rappresenta il tipo di dati che costituiscono un'osservazione. Ciò è indipendente dalla provenienza: un log potrebbe essere fornito esplicitamente dall'utente, estratto tramite l'AI o individuato da un runbook.

Enum
OBSERVATION_TYPE_UNSPECIFIED Valore predefinito.
OBSERVATION_TYPE_CLOUD_LOG Il testo di questa osservazione è una voce di log.
OBSERVATION_TYPE_CLOUD_METRIC Il contenuto di questa osservazione è una metrica o un gruppo di metriche.
OBSERVATION_TYPE_CAIS_CONFIG Una configurazione
OBSERVATION_TYPE_CAIS_CONFIG_DIFF Modifica della configurazione
OBSERVATION_TYPE_CLOUD_ALERT Un avviso
OBSERVATION_TYPE_CICD_EVENT Un evento di un sistema di integrazione continua, ad esempio un errore del probe.
OBSERVATION_TYPE_TEXT_DESCRIPTION Input di testo libero, ad esempio l'input utente iniziale. Può essere in formato Markdown.
OBSERVATION_TYPE_HYPOTHESIS Si tratta di conclusioni [provvisorie] tratte dal sistema. Questi possono diventare input per una revisione successiva. In questo caso, verranno utilizzati i consigli, ma non la correzione.
OBSERVATION_TYPE_STRUCTURED_INPUT Input strutturato, ad es. parametri del runbook inseriti in un modulo
OBSERVATION_TYPE_COMPOSITE Utilizzato per un'osservazione che include più di un tipo di prova, ad esempio l'output di un runbook.
OBSERVATION_TYPE_OTHER L'output del runbook può essere "altro" se non si applica nessuno degli altri tipi.
OBSERVATION_TYPE_LOG_THEME Un tema scoperto nei log.
OBSERVATION_TYPE_CONFIG_ANALYSIS Output dei segnali che include una configurazione analizzata dal modello LLM.
OBSERVATION_TYPE_OUTAGE Output dei segnali che include un'interruzione di PSH.
OBSERVATION_TYPE_KNOWLEDGE Testo che fornisce informazioni sul problema di un determinato utente. Ad esempio, istruzioni/link esterni del catalogo degli errori, RAG e così via.

ObserverType

Rappresenta il modo in cui i dati sono stati inseriti nell'indagine.

Enum
OBSERVER_TYPE_UNSPECIFIED Valore predefinito. Non utilizzata.
OBSERVER_TYPE_DIAGNOSTICS La diagnostica ha una nozione esplicita di cause principali, ad esempio tramite runbook.
OBSERVER_TYPE_SIGNALS Indicatori è per l'elaborazione che non ha cause principali esplicite.
OBSERVER_TYPE_DETERMINISTIC_CODE Questo vale per il codice che dipende solo dai locali. In particolare, le ricerche nel catalogo degli errori.
OBSERVER_TYPE_AI Questo vale per le inferenze dell'AI che dipendono solo dalle osservazioni elencate come premesse.
OBSERVER_TYPE_USER Osservazione dell'input dell'utente, incluse le risposte ai chiarimenti. Tutte le osservazioni specificate dall'utente verranno forzate a questo tipo.
OBSERVER_TYPE_ALERT Un'osservazione da un avviso.

UserRelevance

Rappresenta il giudizio di pertinenza espresso da un utente in merito a un'osservazione.

Enum
USER_RELEVANCE_UNSPECIFIED L'utente non ha contrassegnato questa osservazione come pertinente o irrilevante.
USER_RELEVANCE_PROMOTED L'utente ha contrassegnato questa osservazione come pertinente.
USER_RELEVANCE_REJECTED L'utente ha contrassegnato questa osservazione come irrilevante.

ObservationCompletionState

Determina se l'osservazione è completamente formata e completa.

Enum
OBSERVATION_COMPLETION_STATE_UNSPECIFIED Valore predefinito. Verrà considerato COMPLETATO.
OBSERVATION_COMPLETION_STATE_COMPLETE Questa osservazione è completamente formata.
OBSERVATION_COMPLETION_STATE_INCOMPLETE In questa osservazione mancano alcune informazioni o è necessaria un'ulteriore elaborazione da parte di un altro osservatore. Questo tipo di osservazione potrebbe essere eliminato nelle esecuzioni future dell'indagine.

ObserverStatus

Un ObserverStatus rappresenta lo stato di un osservatore in un determinato momento durante l'esecuzione di un'indagine.

Rappresentazione JSON 
{
  "observer": string,
  "observerExecutionState": enum (ObserverExecution),
  "observerDisplayName": string,
  "updateTime": string,
  "startTime": string,
  "updateComment": string,
  "observerErrors": [
    {
      object (Status)
    }
  ]
}
Campi
observer

string

Solo output. Identifica in modo univoco questo osservatore. È sempre uguale alla chiave della mappa di questo osservatore nell'indagine principale.
observerExecutionState

enum (ObserverExecution)

Facoltativo. Lo stato di esecuzione attuale dell'osservatore.
observerDisplayName

string

Obbligatorio. Nome visualizzato leggibile per l'osservatore.
updateTime

string (Timestamp format)

Facoltativo. La data e l'ora dell'ultimo aggiornamento dell'indagine da parte dell'osservatore. Se lo stato observerExecutionState è COMPLETO o NON RIUSCITO, questo è il momento in cui l'osservatore ha terminato l'osservazione.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
startTime

string (Timestamp format)

Facoltativo. L'ora in cui l'osservatore ha iniziato l'osservazione.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateComment

string

Facoltativo. Un aggiornamento dello stato dell'osservatore.
observerErrors[]

object (Status)

Facoltativo. Un errore che ha impedito a un osservatore di effettuare una determinata osservazione.

ObserverExecution

Lo stato dell'osservatore.

Enum
OBSERVER_EXECUTION_UNSPECIFIED Lo stato dell'osservatore non è specificato.
OBSERVER_EXECUTION_NOT_STARTED L'indagine non è ancora iniziata.
OBSERVER_EXECUTION_RUNNING L'indagine è in corso e questo osservatore è eseguibile o in esecuzione.
OBSERVER_EXECUTION_COMPLETE L'osservatore è terminato senza errori interni.
OBSERVER_EXECUTION_FAILED L'osservatore ha tentato di essere eseguito, ma non è riuscito a causa di un errore. Questo è specifico per un componente e potrebbe essere visualizzato nella UI se l'osservazione viene mostrata con priorità molto bassa.
OBSERVER_EXECUTION_BLOCKED L'osservatore è bloccato in attesa di un input.
OBSERVER_EXECUTION_INVESTIGATION_BLOCKED L'osservatore segnala un errore che blocca o influisce gravemente sull'indagine, ad esempio CAIS o la registrazione disabilitata. Deve essere visualizzato in modo ben visibile nella UI.
OBSERVER_EXECUTION_INVESTIGATION_DEGRADED L'osservatore segnala un errore che peggiora l'indagine e potrebbe richiedere all'utente di riassegnare o ripetere l'indagine dopo aver mitigato la causa.

Metodi

create

 Crea una nuova indagine in un determinato progetto.

delete

 Elimina una singola indagine.

get

 Recupera i dettagli di una singola indagine.

getIamPolicy

 Recupera il criterio di controllo dell'accesso per una risorsa.

list

 Elenca le indagini in un determinato progetto e in una determinata località.

patch

 Aggiorna i parametri di una singola indagine.

setIamPolicy

 Imposta il criterio di controllo dell'accesso sulla risorsa specificata.

testIamPermissions

 Restituisce le autorizzazioni di cui dispone un chiamante per la risorsa specificata.