REST Resource: projects.locations.investigations

Risorsa: Indagine

Messaggio che descrive l'oggetto di indagine ID successivo: 24

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)
    },
    ...
  },
  "clarificationsNeeded": {
    string: {
      object (ClarificationNeeded)
    },
    ...
  }
}
Campi
name

string

Identifier. name of resource
createTime

string (Timestamp format)

Solo output. [Solo output] Crea timestamp

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. [Solo output] Timestamp aggiornamento

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 come coppie chiave-valore

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

string

Solo output. [Solo output] Revisione attuale dell'indagine
revisionIndex

integer

Solo output. [Solo output] Indice della revisione corrente dell'indagine. In base 1.
revisionPredecessor

string

Facoltativo. Il nome della revisione precedente a questa. Ad esempio, l'interfaccia utente lo imposterà sulla revisione esistente quando viene creata una nuova revisione a causa di una modifica.
annotations

object (InvestigationAnnotations)

Facoltativo. Annotazioni sull'indagine. A differenza delle etichette, questi possono avere un significato semantico nell'esecuzione dell'indagine e non verranno letti da altri sistemi come la fatturazione.
executionState

enum (InvestigationExecutionState)

Solo output. [Solo output] Lo stato di esecuzione di questa indagine.
error

object (Status)

Solo output. [Solo output] Se lo stato di esecuzione dell'indagine è FAILED, questo campo conterrà il messaggio di errore.
operation

string

Solo output. L'operazione Esegui eseguita più di recente sull'indagine.
title

string

Obbligatorio. Titolo visualizzato leggibile per l'indagine.
observations

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

Facoltativo. Una mappa dall'ID osservazione all'osservazione. Si tratta di una mappa che ci consente di sovrascrivere in modo pulito le osservazioni precedenti con la versione dell'ultima revisione. Consulta Osservazione per indicazioni sulla scelta degli ID.

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. Versione plurale di quanto sopra. Nel tempo, il codice verrà trasferito a questo.

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

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

Facoltativo. Domande che il sistema deve porre all'utente. I risultati verranno restituiti dalla UI come nuove osservazioni. L'ID di queste osservazioni sarà la chiave della voce nella mappa clarificationsNeeded.

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

InvestigationAnnotations

Annotazioni aggiuntive definite dall'utente in un'indagine. Esistono alcuni valori predefiniti e una mappa per le nuove applicazioni per aggiungere i propri.

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

boolean

Solo output. Per continuare l'indagine è necessario un follow-up. In genere impostato su true dallo strumento per la risoluzione dei problemi e su false quando le domande hanno ricevuto risposta.
extrasMap

map (key: string, value: string)

Facoltativo. Annotazioni aggiuntive richieste dalle applicazioni. Questi dati non verranno oscurati e NON devono contenere CCC/PII.

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

object (Interval)

Facoltativo. Ora di inizio/fine dell'ultima esecuzione della revisione.

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 del sintomo.
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 è l'unità di base di scambio tra l'utente e il sistema o tra i diversi componenti del sistema. È l'elemento che ha una pertinenza. Pertanto, devono essere relativamente piccole; se prevedi che gli utenti reagiscano a una "parte" di un'osservazione, questa deve essere suddivisa in osservazioni più piccole. Una particolare esecuzione di runbook, un particolare input di parametri utente, una particolare voce di log interessante potrebbero essere tutte osservazioni separate. Ciò significa che in un'indagine potrebbero essercene decine o centinaia. Next Id: 26

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

Obbligatorio. Identifica in modo univoco questa osservazione. Deve dipendere dai "contenuti principali" dell'osservazione, ma non, ad esempio, dalla pertinenza. Non deve dipendere da nulla che possa variare in modo imprevedibile da una revisione all'altra. Questa è anche la chiave della mappa nell'indagine principale. Devono essere gerarchici con "." come separatore, a partire dal nome dell'osservatore. Ad esempio, diagnostics.runbook.ABC, signals.logs o user.input.2. Deve essere utilizzabile come componente URL. (Senza distinzione tra maiuscole e minuscole [a-z0-9-._]+) Questi valori non verranno visualizzati dagli utenti, ma saranno visibili nel modello dei dati. Verranno utilizzati dagli ingegneri di Google per localizzare i bug, quindi devono essere semi-leggibili.
timeIntervals[]

object (Interval)

Facoltativo. Quando si è verificata questa osservazione. Le osservazioni devono avere almeno un intervallo di tempo in modo che possano essere visualizzate su una cronologia e possiamo trovare eventi correlati. Per un evento ripetuto ma non continuo, è opportuno avere più di un intervallo. L'interfaccia utente potrebbe combinarli.
title

string

Facoltativo. L'etichetta mostrata nell'interfaccia utente. Non è necessario che sia univoco all'interno di un'indagine. Tuttavia, deve essere specifico e contenere meno di 80 caratteri in modo che l'utente possa esaminare facilmente molte osservazioni. "Nettools pod configured with ALL capabilities dropped" è molto meglio di "Interesting pod configuration".
observationType

enum (ObservationType)

Obbligatorio. Il tipo di osservazione (ad es. log, metrica e così via)
observerType

enum (ObserverType)

Obbligatorio. L'origine dei dati, ad esempio utente, codice di sistema, LLM e così via.
text

string

Facoltativo. Testo in linguaggio naturale [markdown] associato all'osservazione. Si tratta dei contenuti principali, non di una descrizione dei metadati.
data

object (Struct format)

Facoltativo. Una rappresentazione strutturata dell'osservazione, scelta dall'osservatore. Facoltativo. Se presente, un osservatore DOVREBBE fornire anche una descrizione testuale dell'osservazione per facilitarne l'elaborazione da parte di un LLM e il rendering nell'interfaccia utente.
dataUrls

map (key: string, value: string)

Facoltativo. Una mappa dai nomi leggibili agli URL per le prove a supporto. La chiave della mappa verrà visualizzata come testo di ancoraggio dell'URL. Compila questo campo ogni volta che un'osservazione dipende da un elemento esterno al sistema. Ad esempio, query di logging/metriche/ecc. che possono rigenerare l'osservazione.

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

map (key: string, value: string)

Facoltativo. Una mappa dai nomi leggibili agli URL della documentazione.

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 di conclusione registrerà le osservazioni utilizzate per generarla. Un parametro estratto registrerà da cosa è stato estratto. Il grafico di premesse e conclusioni sarà aciclico all'interno di una revisione.
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 [markdown] che descrive un'azione consigliata per correggere / risolvere la causa principale. Al momento questo modulo è libero e non viene elaborato automaticamente. Un consiglio può essere: - Descrizioni di correzioni di alto livello - Passaggi di correzione specifici e tattici con comandi eseguibili - Passaggi di risoluzione dei problemi specifici e tattici per sapere dove indagare successivamente con comandi eseguibili
systemRelevanceScore

number

Facoltativo. Quanto è pertinente questa osservazione per l'indagine, come dedotto dal sistema. Facoltativo. Deve essere compreso nell'intervallo [-1, 1]. Per OBSERVATION_TYPE_HYPOTHESIS, rappresenta la confidenza nella spiegazione. Solo le ipotesi di causa principale vengono classificate l'una rispetto all'altra. Per gli altri ObservationType, questo valore rappresenta un punteggio di pertinenza e i valori vengono classificati in base a questo punteggio. Un valore pari a 0 è neutro.
relevanceOverride

enum (UserRelevance)

Facoltativo. Il giudizio di pertinenza dell'utente.
observationCompletionState

enum (ObservationCompletionState)

Facoltativo. Un ObservationCompletionState indica se l'osservazione emessa è completamente formata e deve essere mostrata all'utente. Lo scopo è consentire di nascondere le osservazioni in uno stato intermedio.
observedNormalOperation

boolean

Facoltativo. Indica se questa osservazione fornisce informazioni su un problema / causa principale (false) o indica il normale funzionamento (true). Questo concetto è diverso dalla pertinenza e viene utilizzato in modo diverso. Un'osservazione non pertinente deve essere nascosta all'LLM e all'utente. Un'osservazione pertinente di un problema deve essere mostrata come osservazione e deve motivare un'ipotesi. Un risultato di normalità pertinente potrebbe essere visualizzato o meno nell'interfaccia utente, ma deve essere utilizzato dal LLM per filtrare le ipotesi confutate dal risultato.

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 Non utilizzare. Specifica il tipo di osservazione. Aggiungi una nuova enumerazione, se necessario.
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 esempio i 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 Non utilizzare. Specifica l'origine dell'osservazione. Aggiungi una nuova enumerazione, se necessario.
OBSERVER_TYPE_DIAGNOSTICS Li separiamo per motivi di attribuzione interna. 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 Si tratta di inferenze dell'AI effettuate lungo il percorso che dipendono solo dalle osservazioni elencate come premesse.
OBSERVER_TYPE_USER Osservazione dell'input dell'utente, incluse le risposte ai chiarimenti.
OBSERVER_TYPE_ALERT Un'osservazione da un avviso esterno a GCA.

UserRelevance

Rappresenta il giudizio di pertinenza espresso dall'utente in merito a un'osservazione. L'interfaccia utente sarà simile a un Mi piace o Non mi piace.

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. Come effetto collaterale, determina se l'osservazione viene mostrata all'utente.

Enum
OBSERVATION_COMPLETION_STATE_UNSPECIFIED Non utilizzare.
OBSERVATION_COMPLETION_STATE_COMPLETE Questa osservazione è completa e deve essere mostrata all'utente.
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 non deve essere mantenuto nelle revisioni future dell'indagine.

ObserverStatus

Un ObserverStatus rappresenta lo stato di un osservatore in un determinato momento durante l'esecuzione di un'indagine. NOTA: per impostazione predefinita, non viene oscurato nulla in questo messaggio. I componenti NON devono inserire PII / CCC qui, tranne nei casi in cui sono oscurati. Next Id: 13

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

string

Obbligatorio. L'ID dell'osservatore a cui si riferisce questo stato. Gli ID osservatore devono essere leggibili e gerarchici, ad esempio "signals.logs.firewall_rules" o "diagnostics.error_catalog".
observerExecutionState

enum (ObserverExecution)

Facoltativo. Stato di esecuzione attuale dell'osservatore.
observerDisplayName

string

Obbligatorio. Il nome da mostrare all'utente quando viene descritto questo osservatore. Tieni presente che l'UI potrebbe sostituire questo valore con una controparte internazionalizzata, pertanto non deve essere generato dinamicamente. Obbligatorio per consentire all'utente di vedere a quale osservatore (ad es. runbook) si riferisce il sistema.
updateTime

string (Timestamp format)

Facoltativo. L'ora in cui è stato aggiornato lo stato. Facoltativo perché è responsabilità dell'osservatore impostarlo. Diventa endTime quando l'osservatore è completo.

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 è iniziato l'osservatore. Facoltativo perché è responsabilità dell'osservatore impostarlo. Al termine dell'osservazione, la differenza tra questo valore e updateTime è il tempo di esecuzione dell'osservatore.

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. Potrebbero essere registrati per scopi di debug. Questi potrebbero essere mostrati agli utenti. Un buon aggiornamento potrebbe essere "parametri corrispondenti, in coda per l'esecuzione" o "file di log controllato 2/5".
observerErrors[]

object (Status)

Facoltativo. Un errore all'interno del sistema di indagine che ha impedito a un osservatore di effettuare una determinata osservazione. La stringa di errore qui verrà mostrata agli utenti. Ripetuto perché un osservatore potrebbe non disporre di più autorizzazioni.

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.

AbsentObservation

Un identificatore di un'osservazione necessaria. In genere un parametro, ma estendibile ad altri casi.

Rappresentazione JSON 
{

  // Union field t can be only one of the following:
  "param": string,
  "generalMissingObservation": {
    object (GeneralAbsentObservation)
  },
  "pendingObservation": string
  // End of list of possible types for union field t.
}
Campi
Campo unione t. Esiste più di un tipo di parametri mancanti. t può essere solo uno dei seguenti:
param

string

Facoltativo. Un parametro runbook.
generalMissingObservation

object (GeneralAbsentObservation)

Facoltativo. Un'osservazione mancante che l'utente potrebbe fornire e che non è un parametro del runbook.
pendingObservation

string

Facoltativo. Un'osservazione non ancora creata che un osservatore deve creare eseguendo. In questo modo, il sistema potrebbe eseguire un runbook.

GeneralAbsentObservation

Un'osservazione assente che non è un parametro runbook.

Rappresentazione JSON 
{
  "id": string,
  "title": string,
  "validationRegex": string
}
Campi
id

string

Facoltativo. L'ID dell'osservazione mancante.
title

string

Facoltativo. Il titolo da visualizzare nell'interfaccia utente.
validationRegex

string

Facoltativo. L'espressione regolare a cui deve corrispondere la risposta. Deve essere conforme alla sintassi del pattern della stringa dell'espressione regolare di JavaScript. Consulta https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp/RegExp#syntax

ObserverLogEntry

Una voce di log di un osservatore.

Rappresentazione JSON 
{
  "logTime": string,
  "logMessage": string,
  "logSeverity": enum (LogSeverity),
  "data": {
    object
  },
  "sensitiveData": {
    object
  }
}
Campi
logTime

string (Timestamp format)

Obbligatorio. L'ora in cui è stato creato il log.

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".
logMessage

string

Obbligatorio. Il messaggio leggibile.
logSeverity

enum (LogSeverity)

Obbligatorio. La gravità del messaggio di log.
data

object (Struct format)

Facoltativo. Eventuali dati aggiuntivi, ad esempio un errore RPC. Avviso: come il resto di ObserverStatus, i contenuti di questo campo possono essere letti a scopo di debug di Observer. Per i dati sensibili, utilizza invece sensitiveData.
sensitiveData

object (Struct format)

Facoltativo. Eventuali dati aggiuntivi che potrebbero contenere informazioni sensibili sul progetto oggetto di indagine. Questo campo verrà oscurato quando viene letto ObserverStatus a scopo di debug.

LogSeverity

La gravità dell'evento descritto in una voce di log, espressa come uno dei livelli di gravità standard elencati di seguito. A titolo di riferimento, ai livelli vengono assegnati i valori numerici elencati. L'effetto dell'utilizzo di valori numerici diversi da quelli elencati non è definito.

Puoi filtrare le voci di log in base alla gravità. Ad esempio, la seguente espressione di filtro corrisponderà alle voci di log con gravità INFO, NOTICE e WARNING:

severity > DEBUG AND severity <= WARNING

Se scrivi voci di log, devi mappare altre codifiche di gravità a uno di questi livelli standard. Ad esempio, puoi mappare tutti i livelli FINE, FINER e FINEST di Java a LogSeverity.DEBUG. Se vuoi, puoi conservare il livello di gravità originale nel payload della voce di log.

Enum
DEFAULT (0) La voce di log non ha un livello di gravità assegnato.
DEBUG (100) Informazioni di debug o tracciamento.
INFO (200) Informazioni di routine, come lo stato o il rendimento in corso.
NOTICE (300) Eventi normali ma significativi, come l'avvio, l'arresto o una modifica della configurazione.
WARNING (400) Gli eventi di avviso potrebbero causare problemi.
ERROR È probabile che gli eventi di errore (500) causino problemi.
CRITICAL (600) Gli eventi critici causano problemi o interruzioni più gravi.
ALERT (700) Una persona deve intraprendere un'azione immediatamente.
EMERGENCY (800) Uno o più sistemi non sono utilizzabili.

ClarificationNeeded

Un chiarimento necessario per il sistema.

Rappresentazione JSON 
{
  "runbookParameter": {
    object (RunbookParameter)
  },
  "generalMissingObservation": {
    object (GeneralAbsentObservation)
  },
  "parentObserverNames": [
    string
  ]
}
Campi
runbookParameter

object (RunbookParameter)

Facoltativo. Il risultato di un chiarimento è un'osservazione. Un parametro runbook che l'utente deve fornire.
generalMissingObservation

object (GeneralAbsentObservation)

Facoltativo. Un'osservazione mancante che non è un parametro runbook.
parentObserverNames[]

string

Facoltativo. I nomi visualizzati degli osservatori che hanno richiesto questo chiarimento. L'interfaccia utente raggrupperà i dati in base a questi nomi.

RunbookParameter

Metadati dei parametri per i runbook aggiornati dall'attività di diagnostica.

Rappresentazione JSON 
{
  "id": string,
  "displayName": string,
  "description": string,
  "exampleValues": [
    string
  ],
  "value": string,
  "associatedAssetTypes": [
    string
  ]
}
Campi
id

string

Facoltativo. Il nome del parametro.
displayName

string

Facoltativo. Il nome del parametro da visualizzare per l'utente.
description

string

Facoltativo. La descrizione del parametro.
exampleValues[]

string

Facoltativo. Esempi di valore del parametro.
value

string

Facoltativo. Il valore del parametro, se disponibile.
associatedAssetTypes[]

string

Facoltativo. Se presente, un elenco dei tipi di risorse a cui potrebbe appartenere questo parametro. Ad esempio, "compute.googleapis.com/Instance".

Metodi

create

 Crea una nuova indagine in un progetto e una località specifici.

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 sulla risorsa specificata.