REST Resource: projects.locations.investigations

Recurso: Investigation

Mensaje que describe el objeto de investigación. Siguiente ID: 24

Representación 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)
    },
    ...
  }
}
Campos
name

string

Identificador. Nombre del recurso.
createTime

string (Timestamp format)

Solo de salida. [Solo salida] Marca de tiempo de creación

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo de salida. [Solo salida] Marca de tiempo de actualización

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "Z". Ejemplos: "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)

Opcional. Etiquetas como pares clave-valor

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }
revision

string

Solo de salida. [Solo salida] Revisión actual de la investigación
revisionIndex

integer

Solo de salida. [Solo salida] Índice de la revisión actual de la investigación. Basado en 1.
revisionPredecessor

string

Opcional. Nombre de la revisión que precedió a esta. Por ejemplo, la interfaz de usuario asignará este valor a la revisión actual cuando se cree una nueva revisión debido a una edición.
annotations

object (InvestigationAnnotations)

Opcional. Anotaciones sobre la investigación. A diferencia de las etiquetas, estas pueden tener un significado semántico en la investigación y no las leerán otros sistemas, como el de facturación.
executionState

enum (InvestigationExecutionState)

Solo de salida. [Solo salida] Estado de ejecución de esta investigación.
error

object (Status)

Solo de salida. [Solo salida] Si el estado de ejecución de la investigación es FAILED, este campo contendrá el mensaje de error.
operation

string

Solo de salida. La operación de ejecución más reciente que se ha realizado en la investigación.
title

string

Obligatorio. Título visible de la investigación legible por humanos.
observations

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

Opcional. Un mapa del ID de la observación a la observación. Se trata de un mapa para que podamos sobrescribir las observaciones antiguas con la versión de la última revisión. Consulta la sección Observación para obtener información sobre cómo elegir los IDs.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }
observerStatuses

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

Opcional. Versión en plural de lo anterior. El código pasará a este con el tiempo.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }
clarificationsNeeded

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

Opcional. Preguntas que el sistema debe hacer al usuario. La interfaz de usuario devolverá los resultados como nuevas observaciones. El ID de esas observaciones será la clave de la entrada en el mapa clarificationsNeeded.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }

InvestigationAnnotations

Anotaciones adicionales definidas por el usuario en una investigación. Hay algunas predefinidas y un mapa para que las nuevas aplicaciones añadan las suyas.

Representación JSON 
{
  "followUp": boolean,
  "extrasMap": {
    string: string,
    ...
  },
  "revisionLastRunInterval": {
    object (Interval)
  }
}
Campos
followUp

boolean

Solo de salida. Es necesario hacer un seguimiento para continuar con la investigación. Por lo general, la herramienta para solucionar problemas le asigna el valor "true" y, cuando se han respondido las preguntas, el valor "false".
extrasMap

map (key: string, value: string)

Opcional. Anotaciones adicionales requeridas por las aplicaciones. No se ocultarán y NO deben contener información confidencial de clientes ni información personal identificable.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }
revisionLastRunInterval

object (Interval)

Opcional. Hora de inicio y de finalización de la última ejecución de la revisión.

Intervalo

Representa un intervalo de tiempo codificado como una marca de tiempo de inicio (inclusiva) y una marca de tiempo de finalización (exclusiva).

El inicio debe ser inferior o igual al final. Si el inicio es igual al final, el intervalo está vacío (no coincide con ningún momento). Si no se especifica ni el inicio ni el final, el intervalo coincide con cualquier momento.

Representación JSON 
{
  "startTime": string,
  "endTime": string
}
Campos
startTime

string (Timestamp format)

Opcional. Inicio inclusivo del intervalo.

Si se especifica, la marca de tiempo que coincida con este intervalo debe ser igual o posterior a la hora de inicio.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Opcional. Fin exclusivo del intervalo.

Si se especifica, la marca de tiempo que coincida con este intervalo deberá ser anterior a la hora de finalización.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

InvestigationExecutionState

El estado de ejecución de una investigación.

Enumeraciones
INVESTIGATION_EXECUTION_STATE_UNSPECIFIED Valor predeterminado. Este valor no se usa.
INVESTIGATION_EXECUTION_STATE_RUNNING Se está llevando a cabo la investigación.
INVESTIGATION_EXECUTION_STATE_MODIFIED La investigación aún no se ha llevado a cabo desde la última vez que se actualizó el síntoma.
INVESTIGATION_EXECUTION_STATE_FAILED La ejecución de la investigación se ha completado, pero ha fallado.
INVESTIGATION_EXECUTION_STATE_COMPLETED Se han completado todas las tareas de ejecución y la investigación está en reposo.

Observación

Una observación es la unidad básica de intercambio entre el usuario y el sistema, o entre los diferentes componentes del sistema. Es el elemento que tiene relevancia. Por lo tanto, deben ser relativamente pequeñas. Si quieres que los usuarios reaccionen a una parte de una observación, debes dividirla en observaciones más pequeñas. Una ejecución de runbook concreta, una entrada de parámetro de usuario concreta o una entrada de registro concreta pueden ser observaciones independientes. Esto significa que puede haber docenas o cientos en una investigación. ID siguiente: 26

Representación 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
}
Campos
id

string

Obligatorio. Identifica de forma única esta observación. Debe depender del "contenido principal" de la observación, pero no de la relevancia, por ejemplo. No debe depender de nada que pueda variar de forma impredecible de una revisión a otra. También es la clave del mapa de la investigación principal. Deben ser jerárquicos y usar el carácter "." como separador, empezando por el nombre del observador. Por ejemplo, diagnostics.runbook.ABC, signals.logs o user.input.2. Debe poder usarse como componente de una URL. No se mostrarán a los usuarios, pero sí en el modelo de datos. No distingue entre mayúsculas y minúsculas [a-z0-9-._]+. Los ingenieros de Google las usarán para localizar errores, por lo que deben ser semi-legibles.
timeIntervals[]

object (Interval)

Opcional. Cuándo se produjo esta observación. Las observaciones deben tener al menos un intervalo de tiempo para que se puedan mostrar en una cronología y podamos encontrar eventos relacionados. En el caso de un evento repetido, pero no continuo, es adecuado tener más de un intervalo. La interfaz de usuario puede combinar estos elementos.
title

string

Opcional. La etiqueta que se muestra en la interfaz de usuario. No es necesario que sea único en una investigación. Sin embargo, debe ser específica y tener menos de 80 caracteres para que el usuario pueda consultar fácilmente muchas observaciones. "Nettools pod configured with ALL capabilities dropped" (Pod de Nettools configurado con TODAS las funciones eliminadas) es mucho mejor que "Interesting pod configuration" (Configuración interesante del pod).
observationType

enum (ObservationType)

Obligatorio. El tipo de observación (por ejemplo, registro, métrica, etc.).
observerType

enum (ObserverType)

Obligatorio. El origen de los datos (por ejemplo, el usuario, el código del sistema o un LLM).
text

string

Opcional. Texto en lenguaje natural [markdown] asociado a la observación. Este es el contenido principal, no una descripción de metadatos.
data

object (Struct format)

Opcional. Una representación estructurada de la observación, tal como la ha elegido el observador. Opcional. Si está presente, un observador TAMBIÉN DEBE proporcionar una descripción de texto de la observación para facilitar el procesamiento por parte de un LLM y la renderización en la interfaz de usuario.
dataUrls

map (key: string, value: string)

Opcional. Una asignación de nombres legibles por humanos a URLs de pruebas de apoyo. La clave del mapa se renderizará como texto de anclaje de URL. Rellena este campo siempre que una observación dependa de algo ajeno al sistema. Por ejemplo, una consulta de registro, métricas, etc. que pueda regenerar la observación.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }
knowledgeUrls

map (key: string, value: string)

Opcional. Una asignación de nombres legibles por humanos a URLs de documentación.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }
baseObservations[]

string

Opcional. Los IDs de otras observaciones en las que se basa esta observación. Por ejemplo, una observación de conclusión registrará las observaciones que se han utilizado para generarla. Un parámetro extraído registrará de dónde se ha extraído. El gráfico de premisas y conclusiones será acíclico en una revisión.
relevantResources[]

string

Opcional. Los recursos de Google Cloud relevantes para la observación. Deben ser URIs de recursos completos, como "//compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-instance"
recommendation

string

Opcional. Texto en lenguaje natural [markdown] que describe una acción recomendada para solucionar la causa raíz. Se trata de un formulario libre que no se procesa automáticamente en este momento. Una recomendación puede ser: - Descripciones generales de las medidas correctivas - Pasos específicos y tácticos para corregir los problemas con comandos ejecutables - Pasos específicos y tácticos para solucionar los problemas y saber dónde investigar a continuación con comandos ejecutables
systemRelevanceScore

number

Opcional. La relevancia de esta observación para la investigación, según la inferencia del sistema. Opcional. Debe estar en el intervalo [-1, 1]. En el caso de OBSERVATION_TYPE_HYPOTHESIS, representa la confianza en la explicación. Solo se comparan entre sí las hipótesis de causa raíz. En el caso de otros ObservationTypes, representa una puntuación de relevancia y se clasifican entre sí. El valor 0 es neutro.
relevanceOverride

enum (UserRelevance)

Opcional. La valoración de relevancia del usuario.
observationCompletionState

enum (ObservationCompletionState)

Opcional. ObservationCompletionState representa si la observación emitida está totalmente formada y debe mostrarse al usuario. El objetivo es permitir que se oculten las observaciones que se encuentren en un estado intermedio.
observedNormalOperation

boolean

Opcional. Indica si esta observación nos proporciona información sobre un problema o una causa principal (false) o si indica un funcionamiento normal (true). Es un concepto diferente de la relevancia y se usa de forma distinta. Una observación irrelevante debe ocultarse de la LLM y del usuario. Una observación pertinente de un problema debe mostrarse como tal y debe motivar una hipótesis. Es posible que en la interfaz de usuario se muestre o no un resultado relevante de normalidad, pero el LLM debería usarlo para descartar las hipótesis que se refuten con el resultado.

ObservationType

Representa el tipo de datos que constituyen una observación. Esto es independiente de la procedencia: un registro puede proporcionarlo explícitamente el usuario, extraerse mediante IA o detectarse mediante un runbook.

Enumeraciones
OBSERVATION_TYPE_UNSPECIFIED No utilices esta enumeración. Especifica el tipo de observación. Añade un nuevo enum si lo necesitas.
OBSERVATION_TYPE_CLOUD_LOG El texto de esta observación es una entrada de registro.
OBSERVATION_TYPE_CLOUD_METRIC El contenido de esta observación es una métrica o un grupo de métricas.
OBSERVATION_TYPE_CAIS_CONFIG Una configuración
OBSERVATION_TYPE_CAIS_CONFIG_DIFF Cambio de configuración
OBSERVATION_TYPE_CLOUD_ALERT Una alerta
OBSERVATION_TYPE_CICD_EVENT Un evento de un sistema de integración continua, como un error de comprobación.
OBSERVATION_TYPE_TEXT_DESCRIPTION Entrada de texto libre, como la entrada inicial del usuario. Puede ser Markdown.
OBSERVATION_TYPE_HYPOTHESIS Se trata de conclusiones [provisionales] extraídas por el sistema. Estos pueden convertirse en entradas para una revisión posterior. En este caso, se usarán las recomendaciones, pero no la corrección.
OBSERVATION_TYPE_STRUCTURED_INPUT Entrada estructurada, por ejemplo, parámetros de runbook introducidos en un formulario
OBSERVATION_TYPE_COMPOSITE Se usa en las observaciones que incluyen más de un tipo de prueba, como la salida de un runbook.
OBSERVATION_TYPE_OTHER El resultado del runbook puede ser "otro" si no se aplica ninguno de los otros tipos.
OBSERVATION_TYPE_LOG_THEME Un tema descubierto en los registros.
OBSERVATION_TYPE_CONFIG_ANALYSIS Señales de salida que incluyen una configuración analizada por un LLM.
OBSERVATION_TYPE_OUTAGE Salida de señales que incluye una interrupción de PSH.
OBSERVATION_TYPE_KNOWLEDGE Texto que proporciona información sobre el problema de un usuario concreto. Por ejemplo, instrucciones del catálogo de errores o enlaces externos, RAG, etc.

ObserverType

Representa cómo se han introducido los datos en la investigación.

Enumeraciones
OBSERVER_TYPE_UNSPECIFIED No utilices esta enumeración. Especifica de dónde procede la observación. Añade un nuevo enum si lo necesitas.
OBSERVER_TYPE_DIAGNOSTICS Las separamos por motivos de atribución internos. Los diagnósticos tienen una noción explícita de las causas principales, por ejemplo, a través de los runbooks.
OBSERVER_TYPE_SIGNALS Signals se usa para procesar datos que no tienen causas raíz explícitas.
OBSERVER_TYPE_DETERMINISTIC_CODE Esto es para código que solo depende de las instalaciones. En concreto, las búsquedas en el catálogo de errores.
OBSERVER_TYPE_AI Se trata de inferencias de IA realizadas a lo largo del proceso que dependen únicamente de las observaciones que se enumeran como premisas.
OBSERVER_TYPE_USER Observación de las entradas de los usuarios, incluidas las respuestas a las aclaraciones.
OBSERVER_TYPE_ALERT Una observación de una alerta externa a GCA.

UserRelevance

Representa el juicio de relevancia expresado por el usuario sobre una observación. La interfaz de usuario será algo parecido a los iconos de Me gusta o No me gusta.

Enumeraciones
USER_RELEVANCE_UNSPECIFIED El usuario no ha marcado esta observación como relevante o irrelevante.
USER_RELEVANCE_PROMOTED El usuario ha marcado esta observación como relevante.
USER_RELEVANCE_REJECTED El usuario ha marcado esta observación como irrelevante.

ObservationCompletionState

Determina si la observación está totalmente formada y completa. Como efecto secundario, esto determina si la observación se muestra al usuario.

Enumeraciones
OBSERVATION_COMPLETION_STATE_UNSPECIFIED No utilices esta enumeración.
OBSERVATION_COMPLETION_STATE_COMPLETE Esta observación está completa y debe mostrarse al usuario.
OBSERVATION_COMPLETION_STATE_INCOMPLETE Falta información en esta observación o necesita que otro observador la procese. Este tipo de Observation no debe conservarse en futuras revisiones de la investigación.

ObserverStatus

ObserverStatus representa el estado de un observador en un momento concreto durante la ejecución de una investigación. NOTA: De forma predeterminada, no se oculta nada de este mensaje. Los componentes NO deben incluir información personal identificable ni información de tarjeta de crédito aquí, excepto si se oculta. ID siguiente: 13

Representación JSON 
{
  "observer": string,
  "observerExecutionState": enum (ObserverExecution),
  "observerDisplayName": string,
  "updateTime": string,
  "startTime": string,
  "updateComment": string,
  "observerErrors": [
    {
      object (Status)
    }
  ]
}
Campos
observer

string

Obligatorio. ID del observador al que corresponde este estado. Los IDs de observador deben ser legibles y jerárquicos, como "signals.logs.firewall_rules" o "diagnostics.error_catalog".
observerExecutionState

enum (ObserverExecution)

Opcional. El estado de ejecución actual del observador.
observerDisplayName

string

Obligatorio. Nombre que se muestra al usuario al describir este observador. Ten en cuenta que la interfaz de usuario podría sustituirlo por una versión internacionalizada, por lo que no se debe generar de forma dinámica. Es necesario para que el usuario pueda ver de qué observador (por ejemplo, un runbook) está hablando el sistema.
updateTime

string (Timestamp format)

Opcional. Hora en la que se actualizó el estado. Es opcional porque el observador es el responsable de configurarlo. Se convierte en endTime cuando se completa el observador.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
startTime

string (Timestamp format)

Opcional. Hora en la que se inició el observador. Es opcional porque el observador es el responsable de configurarlo. Cuando el observador termina, la diferencia entre este valor y updateTime es el tiempo de ejecución del observador.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateComment

string

Opcional. Una actualización del estado del observador. Puede registrarse con fines de depuración. Estos datos se pueden mostrar a los usuarios. Una buena actualización sería "parámetros coincidentes, en cola para ejecutar" o "archivo de registro comprobado 2/5".
observerErrors[]

object (Status)

Opcional. Un error en el sistema de investigación que ha impedido que un observador haga una observación concreta. La cadena de error que se indica aquí se mostrará a los usuarios. Se repite porque es posible que un observador no tenga varios permisos.

ObserverExecution

El estado del observador.

Enumeraciones
OBSERVER_EXECUTION_UNSPECIFIED El estado del observador no está especificado.
OBSERVER_EXECUTION_NOT_STARTED La investigación aún no ha empezado.
OBSERVER_EXECUTION_RUNNING La investigación se está ejecutando y este observador se puede ejecutar o se está ejecutando.
OBSERVER_EXECUTION_COMPLETE El observador ha finalizado sin errores internos.
OBSERVER_EXECUTION_FAILED El observador ha intentado ejecutarse, pero no lo ha conseguido debido a un error. Es específico de un componente y puede renderizarse en la interfaz de usuario si se muestra la observación, con una prioridad muy baja.
OBSERVER_EXECUTION_BLOCKED El observador está bloqueado a la espera de una entrada.
OBSERVER_EXECUTION_INVESTIGATION_BLOCKED El observador informa de un error que bloquea o afecta gravemente a la investigación (por ejemplo, CAIS o registro inhabilitado). Debe mostrarse de forma destacada en la interfaz de usuario.
OBSERVER_EXECUTION_INVESTIGATION_DEGRADED El observador informa de un error que dificulta la investigación, por lo que es posible que el usuario tenga que derivar el problema o volver a ejecutar la investigación después de mitigar la causa.

AbsentObservation

Identificador de una observación necesaria. Normalmente, se trata de un parámetro, pero se puede ampliar a otros casos.

Representación 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.
}
Campos
Campo de unión t. Hay más de un tipo de parámetros que faltan. t solo puede ser una de las siguientes cosas:
param

string

Opcional. Un parámetro de runbook.
generalMissingObservation

object (GeneralAbsentObservation)

Opcional. Una observación que falta y que el usuario podría proporcionar, pero que no es un parámetro de runbook.
pendingObservation

string

Opcional. Una observación que aún no se ha creado y que un observador debería crear ejecutándose. Esto podría provocar que el sistema ejecute un runbook.

GeneralAbsentObservation

Una observación ausente que no es un parámetro de runbook.

Representación JSON 
{
  "id": string,
  "title": string,
  "validationRegex": string
}
Campos
id

string

Opcional. ID de la observación que falta.
title

string

Opcional. Título que se mostrará en la interfaz de usuario.
validationRegex

string

Opcional. La expresión regular con la que debe coincidir la respuesta. Debe ajustarse a la sintaxis del patrón de cadena de expresión regular de JavaScript. Consulta https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp/RegExp#syntax.

ObserverLogEntry

Una entrada de registro de un observador.

Representación JSON 
{
  "logTime": string,
  "logMessage": string,
  "logSeverity": enum (LogSeverity),
  "data": {
    object
  },
  "sensitiveData": {
    object
  }
}
Campos
logTime

string (Timestamp format)

Obligatorio. Hora en la que se creó el registro.

Usa RFC 3339, donde la salida generada siempre se normaliza con Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otros desplazamientos distintos de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
logMessage

string

Obligatorio. El mensaje legible por humanos.
logSeverity

enum (LogSeverity)

Obligatorio. La gravedad del mensaje de registro.
data

object (Struct format)

Opcional. Cualquier dato adicional, como un error de RPC. Advertencia: Al igual que el resto de ObserverStatus, el contenido de este campo se puede leer para depurar Observer. Para los datos sensibles, usa sensitiveData.
sensitiveData

object (Struct format)

Opcional. Cualquier dato adicional que pueda contener información sensible sobre el proyecto investigado. Este campo se ocultará cuando se lea ObserverStatus para depurar.

LogSeverity

La gravedad del evento descrito en una entrada de registro, expresada como uno de los niveles de gravedad estándar que se indican a continuación. Para que lo tengas en cuenta, a los niveles se les asignan los valores numéricos que se indican. El efecto de usar valores numéricos distintos de los que se indican no está definido.

Puedes filtrar las entradas de registro por gravedad. Por ejemplo, la siguiente expresión de filtro coincidirá con las entradas de registro con niveles de gravedad INFO, NOTICE y WARNING:

severity > DEBUG AND severity <= WARNING

Si escribes entradas de registro, debes asignar otras codificaciones de gravedad a uno de estos niveles estándar. Por ejemplo, puedes asignar todos los niveles FINE, FINER y FINEST de Java a LogSeverity.DEBUG. Si quieres, puedes conservar el nivel de gravedad original en la carga útil de la entrada de registro.

Enumeraciones
DEFAULT (0) La entrada de registro no tiene ningún nivel de gravedad asignado.
DEBUG (100) Información de depuración o de seguimiento.
INFO (200) Información rutinaria, como el estado o el rendimiento actuales.
NOTICE (300) Eventos normales pero significativos, como el inicio, el apagado o un cambio de configuración.
WARNING (400) Los eventos de advertencia pueden causar problemas.
ERROR Es probable que los eventos de error (500) causen problemas.
CRITICAL (600) Los eventos críticos provocan problemas o interrupciones más graves.
ALERT (700) Una persona debe tomar medidas inmediatamente.
EMERGENCY (800) Uno o varios sistemas no se pueden usar.

ClarificationNeeded

Una aclaración que necesita el sistema.

Representación JSON 
{
  "runbookParameter": {
    object (RunbookParameter)
  },
  "generalMissingObservation": {
    object (GeneralAbsentObservation)
  },
  "parentObserverNames": [
    string
  ]
}
Campos
runbookParameter

object (RunbookParameter)

Opcional. El resultado de una aclaración es una observación. Un parámetro de runbook que el usuario debe proporcionar.
generalMissingObservation

object (GeneralAbsentObservation)

Opcional. Falta una observación que no es un parámetro de runbook.
parentObserverNames[]

string

Opcional. Los nombres visibles de los observadores que han solicitado esta aclaración. La interfaz de usuario agrupará los elementos por estos nombres.

RunbookParameter

Metadatos de parámetros de runbooks actualizados por la tarea de diagnóstico.

Representación JSON 
{
  "id": string,
  "displayName": string,
  "description": string,
  "exampleValues": [
    string
  ],
  "value": string,
  "associatedAssetTypes": [
    string
  ]
}
Campos
id

string

Opcional. El nombre del parámetro.
displayName

string

Opcional. Nombre del parámetro que se mostrará al usuario.
description

string

Opcional. Descripción del parámetro.
exampleValues[]

string

Opcional. Ejemplos del valor del parámetro.
value

string

Opcional. El valor del parámetro, si está disponible.
associatedAssetTypes[]

string

Opcional. Si está presente, es una lista de tipos de recursos que puede ser este parámetro. Por ejemplo, "compute.googleapis.com/Instance".

Métodos

create

 Crea una investigación en un proyecto y una ubicación determinados.

delete

 Elimina una sola investigación.

get

 Obtiene los detalles de una sola investigación.

getIamPolicy

 Obtiene la política de control de acceso de un recurso.

list

 Muestra las investigaciones de un proyecto y una ubicación determinados.

patch

 Actualiza los parámetros de una sola investigación.

setIamPolicy

 Aplica la política de control de acceso del recurso especificado.

testIamPermissions

 Devuelve los permisos que tiene una sobre el recurso especificado.