REST Resource: projects.locations.investigations

Recurso: Investigación

Es el mensaje que describe el objeto de investigación. ID siguiente: 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 salida. [Solo salida] Marca de tiempo de creación

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z, y usa los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean "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 salida. [Solo salida] Marca de tiempo de actualización

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z, y usa los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean "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 salida. [Solo salida] Revisión actual de la investigación
revisionIndex

integer

Solo salida. [Solo salida] Es el índice de la revisión actual de la investigación. Indexado en 1.
revisionPredecessor

string

Opcional. Es el nombre de la revisión que fue la predecesora de esta revisión. Por ejemplo, la IU establecerá este valor en la revisión existente cuando se cree una nueva debido a una edición.
annotations

object (InvestigationAnnotations)

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

enum (InvestigationExecutionState)

Solo salida. [Solo salida] Es el estado de ejecución de esta investigación.
error

object (Status)

Solo 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 salida. Es la operación de ejecución que se realizó más recientemente en la investigación.
title

string

Obligatorio. Es el título legible por humanos de la investigación.
observations

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

Opcional. Es un mapa que relaciona el ID de observación con la observación. Este es un mapa para que podamos reemplazar sin problemas las observaciones anteriores por la versión de la revisión más reciente. Consulta Observación para obtener orientación sobre cómo elegir 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. Es la versión en plural de lo anterior. Con el tiempo, el código hará la transición a este formato.

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. Son las preguntas que el sistema debe hacerle al usuario. La IU 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

Son anotaciones adicionales definidas por el usuario en una investigación. Hay algunas predefinidas y un mapa para que las aplicaciones nuevas agreguen las suyas.

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

boolean

Solo salida. Se requiere un seguimiento para continuar con la investigación. Por lo general, el solucionador de problemas lo establece como verdadero y como falso cuando se responden las preguntas.
extrasMap

map (key: string, value: string)

Opcional. Son anotaciones adicionales que requieren las aplicaciones. No se ocultarán y NO deben contener CCC/IIP.

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

object (Interval)

Opcional. Es la hora de inicio/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 menor o igual que el final. Cuando el inicio es igual al final, el intervalo está vacío (no coincide con ninguna hora). Cuando no se especifican el inicio ni el final, el intervalo coincide con cualquier hora.

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

string (Timestamp format)

Opcional. Es el inicio inclusivo del intervalo.

Si se especifica, la marca de tiempo que coincida con este intervalo deberá ser igual o posterior al inicio.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z, y usa los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean "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. Es el final exclusivo del intervalo.

Si se especifica, la marca de tiempo que coincida con este intervalo deberá ser anterior al final.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z, y usa los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

InvestigationExecutionState

Es el estado de ejecución de una investigación.

Enums
INVESTIGATION_EXECUTION_STATE_UNSPECIFIED Valor predeterminado. Este valor no se usa.
INVESTIGATION_EXECUTION_STATE_RUNNING Se está ejecutando la investigación.
INVESTIGATION_EXECUTION_STATE_MODIFIED La investigación aún no se ejecutó desde la última actualización del síntoma.
INVESTIGATION_EXECUTION_STATE_FAILED Se completó la ejecución de la investigación, pero se produjo un error.
INVESTIGATION_EXECUTION_STATE_COMPLETED Todas las tareas de ejecución se completaron 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 esperas que los usuarios reaccionen a una "parte" de la observación, esta se debe dividir en observaciones más pequeñas. Una ejecución de runbook, una entrada de parámetro del usuario y una entrada de registro interesante específicas pueden ser observaciones independientes. Esto significa que puede haber decenas o cientos de observaciones 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 esta observación de forma inequívoca. Debe depender del "contenido principal" de la observación, pero no, p. ej., de la relevancia. No debe depender de nada que pueda variar de forma impredecible de una revisión a otra o de una ejecución a otra. Esta también es la clave del mapa en la investigación principal. Deben ser jerárquicos con "." como separador, comenzando con el nombre del observador. Por ejemplo, diagnostics.runbook.ABC, signals.logs o user.input.2 deben poder usarse como componente de URL. (No distingue mayúsculas de minúsculas [a-z0-9-._]+) No se renderizarán para los usuarios, pero serán visibles en el modelo de datos. Los ingenieros de Google las usarán para localizar errores, por lo que deben ser parcialmente legibles.
timeIntervals[]

object (Interval)

Opcional. El momento en que se produjo la observación. Las observaciones deben tener al menos un período para que se puedan mostrar en una línea de tiempo y para que podamos encontrar eventos relacionados. En el caso de un evento repetido, pero no continuo, es adecuado tener más de un período. La IU puede combinar estos elementos.
title

string

Opcional. Es la etiqueta que se muestra en la IU. No es necesario que sea única dentro de una investigación. Sin embargo, debe ser específica y tener menos de 80 caracteres para que el usuario pueda analizar fácilmente muchas observaciones. "Se descartó el pod de Nettools configurado con TODAS las capacidades" es mucho mejor que "Configuración interesante del pod".
observationType

enum (ObservationType)

Obligatorio. Es el tipo de observación (p. ej., registro, métrica, etcétera).
observerType

enum (ObserverType)

Obligatorio. Es el origen de los datos, p. ej., usuario, código del sistema, LLM, etcétera.
text

string

Opcional. Es el 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. Es una representación estructurada de la observación, según la elección del 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 IU.
dataUrls

map (key: string, value: string)

Opcional. Es un mapa que relaciona nombres legibles por humanos con URLs de evidencia de respaldo. La clave del mapa se renderizará como texto de anclaje de la URL. Completa este campo siempre que una observación dependa de algo fuera del 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. Es un mapa que relaciona nombres legibles por humanos con 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. Son 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 usaron para generarla. Un parámetro extraído registrará de dónde se extrajo. El gráfico de las premisas y las conclusiones no tendrá ciclos dentro de una revisión.
relevantResources[]

string

Opcional. Son los recursos de Google Cloud pertinentes para la observación. Deben ser URI de recursos completamente calificados, p. ej., "//compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-instance"
recommendation

string

Opcional. Es un texto en lenguaje natural [Markdown] que describe una acción recomendada para corregir/solucionar la causa raíz. Por el momento, este formato es libre y no se procesa de forma automática. Una recomendación puede incluir lo siguiente: - Descripciones generales de las soluciones. - Pasos de solución específicos y tácticos con comandos ejecutables. - Pasos de solución de problemas específicos y tácticos para saber dónde investigar a continuación con comandos ejecutables.
systemRelevanceScore

number

Opcional. Significa qué tan pertinente es esta observación para la investigación, según la inferencia del sistema. Opcional. Debe estar en el rango [-1, 1]. Para OBSERVATION_TYPE_HYPOTHESIS, representa la confianza en la explicación. Solo se clasifican las hipótesis de causa raíz entre sí. En el caso de otros ObservationTypes, esto representa una puntuación de relevancia y se clasifican entre sí. Un valor de 0 es neutral.
relevanceOverride

enum (UserRelevance)

Opcional. Es la evaluación de relevancia del usuario.
observationCompletionState

enum (ObservationCompletionState)

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

boolean

Opcional. Indica si esta observación nos brinda información sobre un problema o una causa raíz (falso), o si indica un funcionamiento normal (verdadero). Conceptualmente, es diferente de la relevancia y se usa de manera distinta. Una observación que no es pertinente se debe ocultar del LLM y también del usuario. Una observación pertinente de un problema se debe mostrar como una observación y debería dar lugar a una hipótesis. Es posible que en la IU se muestre o no un hallazgo pertinente de normalidad, pero el LLM debes usarlo para filtrar las hipótesis que se refutan con el hallazgo.

ObservationType

Representa el tipo de datos que constituyen una observación. Esto es independiente de la procedencia: el usuario puede proporcionar un registro de forma explícita, o bien se puede extraer a través de la IA, o detectar con un manual de ejecución.

Enums
OBSERVATION_TYPE_UNSPECIFIED No se debe usar. Especifica el tipo de observación. Agrega 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 Es una configuración.
OBSERVATION_TYPE_CAIS_CONFIG_DIFF Es un cambio de configuración.
OBSERVATION_TYPE_CLOUD_ALERT Es una alerta.
OBSERVATION_TYPE_CICD_EVENT Es un evento de un sistema de integración continua, p. ej., una falla del verificador.
OBSERVATION_TYPE_TEXT_DESCRIPTION Es una entrada de texto libre, como la entrada inicial del usuario. Puede ser Markdown.
OBSERVATION_TYPE_HYPOTHESIS Se trata de conclusiones [provisionales] que extrae el sistema. Estos se pueden convertir en entradas para una revisión posterior. En este caso, se usarán las recomendaciones, pero no la corrección.
OBSERVATION_TYPE_STRUCTURED_INPUT Es una entrada estructurada, p. ej., parámetros de un runbook escritos en un formulario.
OBSERVATION_TYPE_COMPOSITE Se usa para una observación que incluye más de un tipo de evidencia, como el resultado 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 Es un tema que se descubrió en los registros.
OBSERVATION_TYPE_CONFIG_ANALYSIS Es un resultado de indicadores que incluye una configuración que analizó el LLM.
OBSERVATION_TYPE_OUTAGE Es la salida de indicadores que incluye una interrupción de PSH.
OBSERVATION_TYPE_KNOWLEDGE Es un texto que proporciona conocimiento sobre el problema de un usuario en particular. Por ejemplo, instrucciones del catálogo de errores/vínculos externos, RAG, etcétera.

ObserverType

Representa cómo llegaron los datos a la investigación.

Enums
OBSERVER_TYPE_UNSPECIFIED No se debe usar. Especifica de dónde provino la observación. Agrega un nuevo enum si lo necesitas.
OBSERVER_TYPE_DIAGNOSTICS Separamos estos datos por motivos de atribución interna. Los diagnósticos tienen una noción explícita de las causas raíz, p. ej., a través de los runbooks.
OBSERVER_TYPE_SIGNALS Los indicadores son para el procesamiento que no tiene causas raíz explícitas.
OBSERVER_TYPE_DETERMINISTIC_CODE Esto es para el código que solo depende a nivel local. En particular, las búsquedas en el catálogo de errores.
OBSERVER_TYPE_AI Esto se aplica a las inferencias de IA que se realizan en el camino y que dependen solo de las observaciones que se enumeran como premisas.
OBSERVER_TYPE_USER Observación de la entrada del usuario, incluidas las respuestas a las aclaraciones.
OBSERVER_TYPE_ALERT Es una observación de una alerta externa a GCA.

UserRelevance

Esto representa la opinión del usuario respecto a la relevancia de una observación. La IU será similar a los íconos de Me gusta o No me gusta.

Enums
USER_RELEVANCE_UNSPECIFIED El usuario no marcó esta observación como pertinente o no pertinente.
USER_RELEVANCE_PROMOTED El usuario marcó esta observación como pertinente.
USER_RELEVANCE_REJECTED El usuario marcó esta observación como no pertinente.

ObservationCompletionState

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

Enums
OBSERVATION_COMPLETION_STATE_UNSPECIFIED No se debe usar.
OBSERVATION_COMPLETION_STATE_COMPLETE Esta observación está completamente formada y se le debe mostrar al usuario.
OBSERVATION_COMPLETION_STATE_INCOMPLETE A esta observación le falta información o necesita que otro observador la procese aún más. Este tipo de observación no debe persistir en revisiones futuras de la investigación.

ObserverStatus

Un ObserverStatus representa el estado de un observador en un momento determinado durante la ejecución de una investigación. NOTA: De forma predeterminada, no se oculta nada en este mensaje. Los componentes NO deben incluir IIP/CCC aquí, excepto cuando se oculten. 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. Es el ID del observador para el que se aplica este estado. Los IDs de observador deben ser legibles por humanos y jerárquicos, p. ej., "signals.logs.firewall_rules" o "diagnostics.error_catalog".
observerExecutionState

enum (ObserverExecution)

Opcional. Es el estado actual de ejecución de la transacción.
observerDisplayName

string

Obligatorio. Es el nombre que se le muestra al usuario cuando se describe este observador. Ten en cuenta que la IU podría reemplazar este valor por uno internacionalizado, por lo que no se debe generar de forma dinámica. Es necesario para que el usuario pueda ver de qué observador (p. ej., runbook) está hablando el sistema.
updateTime

string (Timestamp format)

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

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z, y usa los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean "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. Es la hora en la que comenzó la observación. Es opcional porque el observador es responsable de establecerla. Cuando el observador finaliza, la diferencia entre este valor y updateTime es el tiempo de ejecución del observador.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z, y usa los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateComment

string

Opcional. Es una actualización de estado del observador. Es posible que se registren con fines de depuración. Es posible que se muestren a los usuarios. Una buena actualización sería "Parámetros que coinciden, en cola para su ejecución" o "Se verificó el archivo de registro 2/5".
observerErrors[]

object (Status)

Opcional. Es un error dentro del sistema de investigación que impidió que un observador realizara una observación en particular. La cadena de error que se muestra aquí se mostrará a los usuarios. Se repite porque un observador podría carecer de varios permisos.

ObserverExecution

Es el estado del observador.

Enums
OBSERVER_EXECUTION_UNSPECIFIED El estado del observador no está especificado.
OBSERVER_EXECUTION_NOT_STARTED La investigación aún no comenzó.
OBSERVER_EXECUTION_RUNNING La investigación se está ejecutando y este observador se puede ejecutar o se está ejecutando.
OBSERVER_EXECUTION_COMPLETE El observador finalizó sin errores internos.
OBSERVER_EXECUTION_FAILED El observador intentó ejecutarse, pero falló debido a un error. Esto es específico de un componente y se puede renderizar en la IU si se muestra la observación, ya que tiene una prioridad muy baja.
OBSERVER_EXECUTION_BLOCKED El observador está bloqueado a la espera de una entrada.
OBSERVER_EXECUTION_INVESTIGATION_BLOCKED El observador informa un error que bloquea o afecta gravemente la investigación, por ejemplo, CAIS o registro inhabilitado. Se debe renderizar de forma destacada en la IU.
OBSERVER_EXECUTION_INVESTIGATION_DEGRADED El observador informa un error que degrada la investigación y puede requerir que el usuario derive el caso o vuelva a ejecutar la investigación después de mitigar la causa.

AbsentObservation

Es el identificador de una observación que es necesaria. Por lo general, es un parámetro, pero se puede extender 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 faltantes. t puede ser solo uno de los siguientes:
param

string

Opcional. Es un parámetro del runbook.
generalMissingObservation

object (GeneralAbsentObservation)

Opcional. Es una observación faltante que el usuario podría proporcionar y que no es un parámetro del runbook.
pendingObservation

string

Opcional. Es una observación que aún no se creó y que un observador debería crear ejecutándola. Esto podría hacer que el sistema ejecute un runbook.

GeneralAbsentObservation

Es una observación ausente que no es un parámetro del manual de ejecución.

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

string

Opcional. Es el ID de la observación faltante.
title

string

Opcional. Es el título que se mostrará en la IU.
validationRegex

string

Opcional. Es la regex con la que debe coincidir la respuesta. Debe cumplir con 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

Es 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. Es la hora en la que se creó el registro.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z, y usa los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
logMessage

string

Obligatorio. Es el mensaje legible por humanos.
logSeverity

enum (LogSeverity)

Obligatorio. Es la gravedad del mensaje de registro.
data

object (Struct format)

Opcional. Son los datos adicionales, como un error de RPC. Advertencia: Al igual que el resto de ObserverStatus, el contenido de este campo se puede leer para depurar al observador. Para los datos sensibles, usa sensitiveData en su lugar.
sensitiveData

object (Struct format)

Opcional. Es cualquier dato adicional que pueda contener información sensible sobre el proyecto en investigación. Este campo se ocultará cuando se lea el ObserverStatus con fines de depuración.

LogSeverity

Es la gravedad del evento que se describe en una entrada de registro, expresada como uno de los niveles de gravedad estándar que se indican a continuación. Para tu referencia, los niveles tienen asignados 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 lo deseas, puedes conservar el nivel de gravedad original en la carga útil de la entrada de registro.

Enums
DEFAULT (0) La entrada de registro no tiene un nivel de gravedad asignado.
DEBUG (100) Información de depuración o seguimiento.
INFO (200) Información de rutina, como el estado o el rendimiento en curso.
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 (500) Es probable que los eventos de error causen problemas.
CRITICAL (600) Los eventos fundamentales causan problemas o interrupciones más graves.
ALERT (700) Una persona debe tomar una medida de inmediato.
EMERGENCY (800) Uno o más sistemas no se pueden usar.

ClarificationNeeded

Es 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. Es un parámetro del runbook que el usuario debe proporcionar.
generalMissingObservation

object (GeneralAbsentObservation)

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

string

Opcional. Son los nombres visibles de los observadores que solicitaron esta aclaración. La IU agrupará los elementos por estos nombres.

RunbookParameter

Son los metadatos de los parámetros de los runbooks que actualiza la tarea de diagnóstico.

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

string

Opcional. Es el nombre del parámetro.
displayName

string

Opcional. Es el nombre del parámetro que se mostrará al usuario.
description

string

Opcional. Es la descripción del parámetro.
exampleValues[]

string

Opcional. Son ejemplos del valor del parámetro.
value

string

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

string

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

Métodos

create

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

delete

 Borra una sola investigación.

get

 Obtiene detalles de una sola investigación.

getIamPolicy

 Permite obtener la política de control de acceso de un recurso.

list

 Enumera las investigaciones en una ubicación y un proyecto determinados.

patch

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

setIamPolicy

 Permite configurar la política de control de acceso en el recurso especificado.

testIamPermissions

 Permite mostrar los permisos que tiene un emisor para un recurso especificado.