BillingView

Es el mensaje para informar solicitudes de facturación a través de Eventstream.

Representación JSON
{
  "reportRequests": [
    {
      object (ReportRequest)
    }
  ]
}
Campos
reportRequests[]

object (ReportRequest)

Solicitudes de facturación que se deben informar para cloud.eventstream.v2.ResourceEvent

ReportRequest

Es el mensaje de solicitud para el método services.report.

Representación JSON
{
  "serviceName": string,
  "operations": [
    {
      object (Operation)
    }
  ],
  "serviceConfigId": string
}
Campos
serviceName

string

Nombre del servicio, tal como se especifica en su configuración del servicio. Por ejemplo, "pubsub.googleapis.com".

Consulta google.api.Service para obtener la definición de un nombre de servicio.

operations[]

object (Operation)

Son las operaciones que se deben informar.

Por lo general, el servicio debe informar una operación por solicitud. Se permite incluir varias operaciones en una sola solicitud, pero solo se debe hacer cuando varias operaciones estén disponibles de forma natural en el momento del informe.

No hay límite para la cantidad de operaciones en el mismo ReportRequest, pero el tamaño de ReportRequest no debe superar 1 MB. Consulta ReportResponse.report_errors para conocer el comportamiento en caso de falla parcial.

serviceConfigId

string

Especifica qué versión de la configuración del servicio se debe usar para procesar la solicitud.

Si no se especifica o no se encuentra una versión coincidente, se usará la más reciente.

Operación

Representa información sobre una operación.

Representación JSON
{
  "operationId": string,
  "operationName": string,
  "consumerId": string,
  "startTime": string,
  "endTime": string,
  "labels": {
    string: string,
    ...
  },
  "metricValueSets": [
    {
      object (MetricValueSet)
    }
  ],
  "logEntries": [
    {
      object (LogEntry)
    }
  ],
  "quotaProperties": {
    object (QuotaProperties)
  },
  "importance": enum (Importance),
  "userLabels": {
    string: string,
    ...
  },
  "resources": [
    {
      object (ResourceInfo)
    }
  ],
  "traceSpans": [
    {
      object (TraceSpan)
    }
  ]
}
Campos
operationId

string

Es la identidad de la operación. Debe ser único dentro del alcance del servicio que generó la operación. Si el servicio llama a services.check() y services.report() en la misma operación, las dos llamadas deben tener el mismo ID.

Se recomienda usar la versión 4 del UUID, aunque no es obligatorio. En situaciones en las que una operación se calcula a partir de información existente y se desea un ID idempotente para fines de deduplicación, se recomienda la versión 5 del UUID. Consulta el RFC 4122 para obtener más detalles.

operationName

string

Es el nombre completamente calificado de la operación. Se reserva para usarlo más adelante.

consumerId

string

Es la identidad del consumidor que usa el servicio. Este campo debe completarse para las operaciones iniciadas por un consumidor, pero no para las operaciones iniciadas por el servicio que no están relacionadas con un consumidor específico.

  • Puede tener uno de los siguientes formatos:
    • project:PROJECT_ID,
    • project_number:PROJECT_NUMBER,
    • projects/PROJECT_ID o PROJECT_NUMBER
    • folders/FOLDER_NUMBER,
    • organizations/ORGANIZATION_NUMBER,
    • api_key:API_KEY.
startTime

string (Timestamp format)

Obligatorio. Hora de inicio de la operación.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y 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)

Es la hora de finalización de la operación. Es obligatorio cuando la operación se usa en ServiceController.Report, pero opcional cuando se usa en ServiceController.Check.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y 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)

Son etiquetas que describen la operación. Solo se permiten las siguientes etiquetas:

  • Son etiquetas que describen los recursos supervisados, según se definen en la configuración del servicio.
  • Son las etiquetas predeterminadas de los valores de las métricas. Cuando se especifican, las etiquetas definidas en el valor de la métrica anulan estos valores predeterminados.
  • Las siguientes etiquetas definidas por Google Cloud Platform:
    • cloud.googleapis.com/location que describe la ubicación en la que se realizó la operación
    • servicecontrol.googleapis.com/userAgent que describe el usuario-agente de la solicitud a la API
    • servicecontrol.googleapis.com/service_agent que describe el servicio que se usa para controlar la solicitud a la API (p.ej., ESP)
    • servicecontrol.googleapis.com/platform que describe la plataforma en la que se entrega la API, como App Engine, Compute Engine o Kubernetes Engine.

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

metricValueSets[]

object (MetricValueSet)

Representa información sobre esta operación. Cada MetricValueSet corresponde a una métrica definida en la configuración del servicio. El tipo de datos que se usa en MetricValueSet debe coincidir con el tipo de datos especificado en la definición de la métrica.

En una sola operación, no se permite tener más de una instancia de MetricValue que tenga los mismos nombres de métricas y combinaciones idénticas de valores de etiquetas. Si una solicitud tiene instancias de MetricValue duplicadas, se rechaza toda la solicitud con un error de argumento no válido.

logEntries[]

object (LogEntry)

Representa la información que se registrará.

quotaProperties

object (QuotaProperties)

Representa las propiedades necesarias para la verificación de cuota. Solo se aplica si esta operación es para una solicitud de verificación de cuota. Si no se especifica, no se realizará ninguna verificación de cuota.

importance

enum (Importance)

NO USAR. Este es un campo experimental.

userLabels

map (key: string, value: string)

Vista previa privada. Esta función solo está disponible para los servicios aprobados.

Son etiquetas definidas por el usuario para el recurso con el que se asocia esta operación.

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

resources[]

object (ResourceInfo)

Son los recursos que participan en la operación. La cantidad máxima de entradas admitidas en este campo es 100.

traceSpans[]

object (TraceSpan)

Sin implementar. Es una lista de intervalos de Cloud Trace. Los nombres de los tramos deben contener el ID del proyecto de destino, que puede ser el proyecto de producción o el proyecto del consumidor.

MetricValueSet

Representa un conjunto de valores de métricas en la misma métrica. Cada valor de métrica del conjunto debe tener una combinación única de hora de inicio, hora de finalización y valores de etiqueta.

Representación JSON
{
  "metricName": string,
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
Campos
metricName

string

Es el nombre de la métrica definida en la configuración del servicio.

metricValues[]

object (MetricValue)

Son los valores de esta métrica.

MetricValue

Representa un solo valor de métrica.

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

  // Union field value can be only one of the following:
  "boolValue": boolean,
  "int64Value": string,
  "doubleValue": number,
  "stringValue": string,
  "distributionValue": {
    object (Distribution)
  },
  "moneyValue": {
    object (Money)
  }
  // End of list of possible types for union field value.
}
Campos
labels

map (key: string, value: string)

Son las etiquetas que describen el valor de la métrica. Consulta los comentarios en google.api.servicecontrol.v1.Operation.labels para ver la relación de anulación. Ten en cuenta que este mapa no debe contener etiquetas de recurso supervisado.

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

startTime

string (Timestamp format)

Es el inicio del período durante el cual se aplica la medición del valor de esta métrica. El período tiene diferentes semánticas para los distintos tipos de métricas (acumulativa, delta y de indicador). Consulta la documentación de la definición de métricas en la configuración del servicio para obtener más detalles. Si no se especifica, se usará google.api.servicecontrol.v1.Operation.start_time.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y 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)

Es el final del período durante el que se aplica la medición de este valor de la métrica. Si no se especifica, se usará google.api.servicecontrol.v1.Operation.end_time.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y 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".

Campo de unión value. Es el valor. El tipo de valor que se usa en la solicitud debe coincidir con la definición de la métrica en la configuración del servicio. De lo contrario, se rechazará el MetricValue. value puede ser solo uno de los parámetros siguientes:
boolValue

boolean

Un valor booleano

int64Value

string (int64 format)

Es un valor de número entero de 64 bits con firma.

doubleValue

number

Es un valor de punto flotante de doble precisión.

stringValue

string

Es un valor de cadena de texto.

distributionValue

object (Distribution)

Un valor de distribución.

moneyValue

object (Money)

Es un valor monetario.

Distribución

La distribución representa una distribución de frecuencia de puntos de muestra con valores dobles. Contiene el tamaño de la población de puntos de muestra más información opcional adicional:

  • la media aritmética de las muestras
  • el mínimo y el máximo de las muestras
  • La suma de las desviaciones cuadráticas de las muestras, que se usa para calcular la varianza
  • Un histograma de los valores de los puntos de la muestra
Representación JSON
{
  "count": string,
  "mean": number,
  "minimum": number,
  "maximum": number,
  "sumOfSquaredDeviation": number,
  "bucketCounts": [
    string
  ],
  "exemplars": [
    {
      object (Exemplar)
    }
  ],

  // Union field bucket_option can be only one of the following:
  "linearBuckets": {
    object (LinearBuckets)
  },
  "exponentialBuckets": {
    object (ExponentialBuckets)
  },
  "explicitBuckets": {
    object (ExplicitBuckets)
  }
  // End of list of possible types for union field bucket_option.
}
Campos
count

string (int64 format)

Es la cantidad total de muestras en la distribución. Debe ser >= 0.

mean

number

Es la media aritmética de las muestras en la distribución. Si count es cero, este campo debe ser cero.

minimum

number

Es el mínimo de la población de valores. Se ignora si count es cero.

maximum

number

Es el valor máximo de la población de valores. Se ignora si count es cero.

sumOfSquaredDeviation

number

La suma de las desviaciones al cuadrado de la media: Sum[i=1..count]((x_i - mean)^2), donde cada x_i es un valor de muestra. Si count es cero, este campo debe ser cero; de lo contrario, fallará la validación de la solicitud.

bucketCounts[]

string (int64 format)

Es la cantidad de muestras en cada bucket del histograma. bucketCounts son opcionales. Si están presentes, deben sumar el valor de count.

Los buckets se definen a continuación en bucket_option. Hay N buckets. bucketCounts[0] es la cantidad de muestras en el bucket de subflujo. bucketCounts[1] a bucketCounts[N-1] son las cantidades de muestras en cada uno de los buckets finitos. Además, bucketCounts[N] es la cantidad de muestras en el bucket de desbordamiento. Consulta los comentarios de bucket_option a continuación para obtener más detalles.

Se puede omitir cualquier sufijo de ceros finales.

exemplars[]

object (Exemplar)

Puntos de ejemplo. Debe estar en orden creciente del campo value.

Campo de unión bucket_option. Define los buckets en el histograma. bucket_option y bucket_counts deben establecerse o no establecerse ambos.

Los buckets se numeran en el rango de [0, N], con un total de N+1 buckets. Debe haber al menos dos buckets (un histograma de una sola bucket no proporciona información que count no proporcione ya).

El primer bucket es el de subdesbordamiento, que tiene un límite inferior de -inf. El último bucket es el de desbordamiento, que tiene un límite superior de +inf. Todos los demás buckets (si los hay) se denominan "finitos" porque tienen límites inferior y superior finitos. Como se describe a continuación, hay tres formas de definir los buckets finitas.

(1) Son buckets con un ancho constante. (2) Buckets con anchos que crecen de forma exponencial. (3) Intervalos con anchos arbitrarios proporcionados por el usuario.

En todos los casos, los buckets abarcan toda la recta numérica real (-inf, +inf). Los límites superiores de los buckets son exclusivos y los límites inferiores son inclusivos. El límite superior del bucket de subdesbordamiento es igual al límite inferior del bucket finito más pequeño, y el límite inferior del bucket de desbordamiento es igual al límite superior del bucket finito más grande. bucket_option puede ser una de las siguientes opciones:

linearBuckets

object (LinearBuckets)

Son buckets con un ancho constante.

exponentialBuckets

object (ExponentialBuckets)

Son buckets con un ancho que crece de forma exponencial.

explicitBuckets

object (ExplicitBuckets)

Son buckets con un ancho arbitrario proporcionado por el usuario.

LinearBuckets

Describe los buckets con un ancho constante.

Representación JSON
{
  "numFiniteBuckets": integer,
  "width": number,
  "offset": number
}
Campos
numFiniteBuckets

integer

Es la cantidad de buckets finitas. Con los buckets de subdesbordamiento y desbordamiento, la cantidad total de buckets es numFiniteBuckets + 2. Consulta los comentarios en bucketOptions para obtener más información.

width

number

El bucket lineal i-ésimo abarca el intervalo [offset + (i-1) * width, offset + i * width), donde i varía de 1 a numFiniteBuckets, inclusive. Debe ser estrictamente positivo.

offset

number

El bucket lineal i-ésimo abarca el intervalo [offset + (i-1) * width, offset + i * width), donde i varía de 1 a numFiniteBuckets, inclusive.

ExponentialBuckets

Describe los buckets con un ancho que crece de forma exponencial.

Representación JSON
{
  "numFiniteBuckets": integer,
  "growthFactor": number,
  "scale": number
}
Campos
numFiniteBuckets

integer

Es la cantidad de buckets finitas. Con los buckets de subdesbordamiento y desbordamiento, la cantidad total de buckets es numFiniteBuckets + 2. Consulta los comentarios en bucketOptions para obtener más información.

growthFactor

number

El i-ésimo bucket exponencial abarca el intervalo [escala * factor de crecimiento^(i-1), escala * factor de crecimiento^i), donde i varía de 1 a numFiniteBuckets inclusive. Debe ser mayor que 1.0.

scale

number

El i-ésimo bucket exponencial abarca el intervalo [escala * factor de crecimiento^(i-1), escala * factor de crecimiento^i), donde i varía de 1 a numFiniteBuckets inclusive. Debe ser mayor que 0.

ExplicitBuckets

Describe buckets con un ancho arbitrario proporcionado por el usuario.

Representación JSON
{
  "bounds": [
    number
  ]
}
Campos
bounds[]

number

"bound" es una lista de límites estrictamente crecientes entre buckets. Ten en cuenta que una lista de longitud N-1 define N buckets debido a la publicación de vallas. Consulta los comentarios en bucketOptions para obtener más información.

El bucket finito i-ésimo abarca el intervalo [límite[i-1], límite[i]), donde i varía de 1 a bound_size() - 1. Ten en cuenta que no hay buckets finitos si "bound" solo contiene un elemento. En ese caso especial, el único límite define el límite entre los buckets de subdesbordamiento y desbordamiento.

número de bucket límite inferior límite superior i == 0 (subdesbordamiento) -inf límite[i] 0 < i < bound_size() límite[i-1] límite[i] i == bound_size() (desbordamiento) límite[i-1] +inf

Exemplar

Los ejemplares son puntos de ejemplo que se pueden usar para anotar valores de distribución agregados. Son metadatos que proporcionan información sobre un valor específico agregado a un bucket de distribución, como un ID de seguimiento que estuvo activo cuando se agregó un valor. Pueden contener más información, como valores de ejemplo y marcas de tiempo, origen, etcétera.

Representación JSON
{
  "value": number,
  "timestamp": string,
  "attachments": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Campos
value

number

Valor del punto ejemplar. Este valor determina a qué bucket pertenece el ejemplo.

timestamp

string (Timestamp format)

El tiempo de observación (muestreo) del valor anterior.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y 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".

attachments[]

object

Información contextual sobre el valor del ejemplo. Por ejemplo:

Trace: type.googleapis.com/google.monitoring.v3.SpanContext

Cadena literal: type.googleapis.com/google.protobuf.StringValue

Etiquetas descartadas durante la agregación: type.googleapis.com/google.monitoring.v3.DroppedLabels

Es posible que haya solo un archivo adjunto de un tipo de mensaje dado en un solo ejemplar, y el sistema lo aplicará de manera forzosa.

Un objeto que contiene campos de un tipo arbitrario. Un campo adicional "@type" contiene una URI que identifica el tipo. Ejemplo: { "id": 1234, "@type": "types.example.com/standard/id" }.

Dinero

Representa un importe de dinero con su tipo de moneda.

Representación JSON
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Campos
currencyCode

string

Es el código de moneda de tres letras definido en la norma ISO 4217.

units

string (int64 format)

La unidad entera del importe. Por ejemplo, si currencyCode es "USD", 1 unidad es un dólar estadounidense.

nanos

integer

Número de unidades nano (10^-9) del importe. Debe ser un valor entre -999,999,999 y +999,999,999. Si units es positivo, nanos debe ser positivo o cero. Si units es cero, nanos puede ser positivo, cero o negativo. Si units es negativo, nanos debe ser negativo o cero. Por ejemplo, –$1.75 se representa como units=-1 y nanos=-750,000,000.

LogEntry

Es una entrada de registro individual.

Representación JSON
{
  "name": string,
  "timestamp": string,
  "severity": enum (LogSeverity),
  "httpRequest": {
    object (HttpRequest)
  },
  "trace": string,
  "insertId": string,
  "labels": {
    string: string,
    ...
  },
  "operation": {
    object (LogEntryOperation)
  },
  "sourceLocation": {
    object (LogEntrySourceLocation)
  },

  // Union field payload can be only one of the following:
  "protoPayload": {
    "@type": string,
    field1: ...,
    ...
  },
  "textPayload": string,
  "structPayload": {
    object
  }
  // End of list of possible types for union field payload.
}
Campos
name

string

Obligatorio. Es el registro al que pertenece esta entrada de registro. Ejemplos: "syslog", "book_log".

timestamp

string (Timestamp format)

Indica la fecha y hora en la que ocurrió el evento que se describe en la entrada de registro. Si se omite, el valor predeterminado es la hora de inicio de la operación.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y 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".

severity

enum (LogSeverity)

La gravedad de la entrada de registro. El valor predeterminado es LogSeverity.DEFAULT.

httpRequest

object (HttpRequest)

Es opcional. Es la información sobre la solicitud HTTP asociada a esta entrada de registro, si corresponde.

trace

string

Es opcional. Nombre del recurso del seguimiento asociado a la entrada de registro, si corresponde. Si este campo contiene un nombre de recurso relativo, puedes suponer que el nombre es relativo a //tracing.googleapis.com. Ejemplo: projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824

insertId

string

Es un ID único para la entrada de registro que se usa para la anulación de duplicación. Si se omite, la implementación generará uno según operationId.

labels

map (key: string, value: string)

Es un conjunto de datos (clave, valor) definidos por el usuario que proporciona información adicional sobre la entrada de registro.

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

operation

object (LogEntryOperation)

Es opcional. Es la información sobre una operación asociada a la entrada de registro, si corresponde.

sourceLocation

object (LogEntrySourceLocation)

Es opcional. Es la información de ubicación del código fuente asociada a la entrada de registro, si es que existe.

Campo de unión payload. Es la carga útil de la entrada de registro, que puede ser de varios tipos. payload puede ser solo uno de los parámetros siguientes:
protoPayload

object

Indica la carga útil de la entrada de registro, representada como un búfer de protocolo que se expresa como un objeto JSON. Actualmente, el único tipo aceptado es AuditLog.

Un objeto que contiene campos de un tipo arbitrario. Un campo adicional "@type" contiene una URI que identifica el tipo. Ejemplo: { "id": 1234, "@type": "types.example.com/standard/id" }.

textPayload

string

Es la carga útil de la entrada de registro, representada como una cadena Unicode (UTF-8).

structPayload

object (Struct format)

Indica la carga útil de la entrada de registro, representada como una estructura que se expresa como un objeto JSON.

HttpRequest

Es un proto común para registrar solicitudes HTTP. Solo contiene la semántica definida por la especificación HTTP. La información de registro específica del producto SE DEBE definir en un mensaje independiente.

Representación JSON
{
  "requestMethod": string,
  "requestUrl": string,
  "requestSize": string,
  "status": integer,
  "responseSize": string,
  "userAgent": string,
  "remoteIp": string,
  "serverIp": string,
  "referer": string,
  "latency": string,
  "cacheLookup": boolean,
  "cacheHit": boolean,
  "cacheValidatedWithOriginServer": boolean,
  "cacheFillBytes": string,
  "protocol": string
}
Campos
requestMethod

string

Es el método de la solicitud. Ejemplos: "GET", "HEAD", "PUT", "POST".

requestUrl

string

Esquema (http, https), nombre de host, ruta de acceso y parte de la consulta de la URL que se solicitó. Ejemplo: "http://example.com/some/info?color=red".

requestSize

string (int64 format)

Es el tamaño del mensaje de solicitud HTTP en bytes, incluidos los encabezados y el cuerpo de la solicitud.

status

integer

Es el código de respuesta que indica el estado de la respuesta. Ejemplos: 200, 404.

responseSize

string (int64 format)

Es el tamaño del mensaje de respuesta HTTP que se envía al cliente, en bytes, incluidos los encabezados y el cuerpo de la respuesta.

userAgent

string

Es el usuario-agente que envía el cliente. Ejemplo: "Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)".

remoteIp

string

La dirección IP (IPv4 o IPv6) del cliente que emitió la solicitud HTTP. Ejemplos: "192.168.1.1", "FE80::0202:B3FF:FE1E:8329".

serverIp

string

Es la dirección IP (IPv4 o IPv6) del servidor de origen al que se envió la solicitud.

referer

string

Es la URL de referencia de la solicitud, como se define en HTTP/1.1 Header Field Definitions.

latency

string (Duration format)

Es la latencia de procesamiento de la solicitud en el servidor, desde el momento en que se recibió la solicitud hasta que se envió la respuesta.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

cacheLookup

boolean

Indica si se intentó una búsqueda en la caché.

cacheHit

boolean

Indica si una entidad se entregó desde la caché (con o sin validación).

cacheValidatedWithOriginServer

boolean

Indica si la respuesta se validó con el servidor de origen antes de entregarse desde la caché. Este campo solo es significativo si cacheHit es verdadero.

cacheFillBytes

string (int64 format)

Es la cantidad de bytes de respuesta HTTP insertados en la caché. Solo se establece cuando se intentó completar la caché.

protocol

string

Protocolo que se usa para la solicitud Ejemplos: "HTTP/1.1", "HTTP/2", "websocket"

LogEntryOperation

Es información adicional sobre una operación potencialmente de larga duración con la que se asocia una entrada de registro.

Representación JSON
{
  "id": string,
  "producer": string,
  "first": boolean,
  "last": boolean
}
Campos
id

string

Es opcional. Es un identificador de operación arbitrario. Se supone que las entradas de registro con el mismo identificador forman parte de la misma operación.

producer

string

Es opcional. Es un identificador de productor arbitrario. La combinación de id y producer debe ser única a nivel global. Ejemplos para producer: "MyDivision.MyBigCompany.com", "github.com/MyProject/MyApplication".

first

boolean

Es opcional. Establece este valor en True si esta es la primera entrada de registro de la operación.

last

boolean

Es opcional. Establece este valor en verdadero si esta es la última entrada de registro de la operación.

LogEntrySourceLocation

Es información adicional sobre la ubicación del código fuente que produjo la entrada de registro.

Representación JSON
{
  "file": string,
  "line": string,
  "function": string
}
Campos
file

string

Es opcional. Es el nombre del archivo fuente. Según el entorno de ejecución, puede ser un nombre simple o un nombre completamente calificado.

line

string (int64 format)

Es opcional. Línea dentro del archivo de origen Basado en 1. El 0 indica que no hay un número de línea disponible.

function

string

Es opcional. Nombre legible de la función o el método que se invoca, con contexto opcional, como el nombre de la clase o el paquete. Esta información se puede usar en contextos como el visor de registros, en el que un archivo y un número de línea son menos significativos. El formato puede variar según el idioma. Por ejemplo: qual.if.ied.Class.method (Java), dir/package.func (Go), function (Python).

QuotaProperties

Representa las propiedades necesarias para las operaciones de cuota.

Representación JSON
{
  "quotaMode": enum (QuotaMode)
}
Campos
quotaMode

enum (QuotaMode)

Es el modo de cuota para esta operación.

ResourceInfo

Describe un recurso asociado a esta operación.

Representación JSON
{
  "resourceContainer": string,
  "resourceName": string,
  "resourceLocation": string,
  "permission": string
}
Campos
resourceContainer

string

Es el identificador del elemento principal de esta instancia de recurso. Debe tener uno de los siguientes formatos: - projects/<project-id or project-number> - folders/<folder-id> - organizations/<organization-id>

resourceName

string

Indica el nombre del recurso. Esto se usa para fines de auditoría.

resourceLocation

string

Ubicación del recurso. Si no está vacío, el recurso se verificará según la política de ubicación. El valor debe ser una zona, una región o una multirregión válidas. Por ejemplo: "europe-west4" o "northamerica-northeast1-a"

permission

string

Es el permiso de recurso requerido para esta solicitud.

TraceSpan

Un intervalo representa una sola operación dentro de un registro de seguimiento. Los tramos se pueden anidar para formar un árbol de seguimiento. A menudo, un registro de seguimiento contiene un intervalo raíz que describe la latencia de extremo a extremo y uno o más subintervalos para sus suboperaciones. Un registro también puede contener varios intervalos raíz o ninguno. Los tramos no tienen que ser contiguos; puede haber brechas o superposiciones entre los tramos de un registro.

Representación JSON
{
  "name": string,
  "spanId": string,
  "parentSpanId": string,
  "displayName": {
    object (TruncatableString)
  },
  "startTime": string,
  "endTime": string,
  "attributes": {
    object (Attributes)
  },
  "status": {
    object (Status)
  },
  "sameProcessAsParentSpan": boolean,
  "childSpanCount": integer,
  "spanKind": enum (SpanKind)
}
Campos
name

string

Nombre del recurso del intervalo en el siguiente formato:

projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]

[TRACE_ID] es un identificador único para un registro dentro de un proyecto; es una codificación hexadecimal de 32 caracteres de un array de 16 bytes.

[SPAN_ID] es un identificador único para un intervalo dentro de un registro; es una codificación hexadecimal de 16 caracteres de un array de 8 bytes.

spanId

string

Es la parte [SPAN_ID] del nombre del recurso del tramo.

parentSpanId

string

Es el [SPAN_ID] del intervalo principal de este intervalo. Si se trata de un tramo raíz, este campo debe estar vacío.

displayName

object (TruncatableString)

Es una descripción de la operación del intervalo (hasta 128 bytes). Stackdriver Trace muestra la descripción en Google Cloud Platform Console. Por ejemplo, el nombre visible puede ser un nombre de método calificado o un nombre de archivo y un número de línea en el que se llama a la operación. Se recomienda usar el mismo nombre visible dentro de una aplicación y en el mismo punto de llamada. Esto facilita la correlación de intervalos en diferentes registros.

startTime

string (Timestamp format)

Es la hora de inicio del período. En el cliente, es la hora que mantiene la máquina local en la que comienza la ejecución del intervalo. En el servidor, es el momento en que comienza a ejecutarse el controlador de la aplicación del servidor.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y 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)

Es la hora de finalización del período. En el cliente, es la hora que mantiene la máquina local en la que finaliza la ejecución del intervalo. En el servidor, es el momento en que el controlador de la aplicación del servidor deja de ejecutarse.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y 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".

attributes

object (Attributes)

Es un conjunto de atributos del intervalo. Puedes tener hasta 32 atributos por tramo.

status

object (Status)

Es un estado final opcional para este intervalo.

sameProcessAsParentSpan

boolean

(Opcional) Establece este parámetro para indicar si este intervalo se encuentra en el mismo proceso que su elemento superior. Si no configuras este parámetro, Stackdriver Trace no podrá aprovechar esta información útil.

childSpanCount

integer

Es una cantidad opcional de intervalos secundarios que se generaron mientras este intervalo estaba activo. Si se configura, permite que la implementación detecte los tramos secundarios faltantes.

spanKind

enum (SpanKind)

Distingue entre los tramos generados en un contexto particular. Por ejemplo, dos intervalos con el mismo nombre se pueden distinguir con CLIENT (llamador) y SERVER (llamado) para identificar una llamada a RPC.

TruncatableString

Representa una cadena que se puede acortar a una longitud especificada.

Representación JSON
{
  "value": string,
  "truncatedByteCount": integer
}
Campos
value

string

Es la cadena abreviada. Por ejemplo, si la cadena original tiene 500 bytes de longitud y el límite de la cadena es de 128 bytes, value contiene los primeros 128 bytes de la cadena de 500 bytes.

El truncamiento siempre se produce en un límite de caracteres UTF8. Si hay caracteres multibyte en la cadena, la longitud de la cadena abreviada podría ser inferior al límite de tamaño.

truncatedByteCount

integer

Es la cantidad de bytes que se quitaron de la cadena original. Si este valor es 0, la cadena no se acortó.

Atributos

Es un conjunto de atributos, cada uno en formato [KEY]:[VALUE].

Representación JSON
{
  "attributeMap": {
    string: {
      object (AttributeValue)
    },
    ...
  },
  "droppedAttributesCount": integer
}
Campos
attributeMap

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

Es el conjunto de atributos. La clave de cada atributo puede tener hasta 128 bytes de longitud. El valor puede ser una cadena de hasta 256 bytes, un número entero de 64 bits con signo o los valores booleanos true y false. Por ejemplo:

"/instance_id": "my-instance"
"/http/userAgent": ""
"/http/request_bytes": 300
"example.com/myattribute": true

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

droppedAttributesCount

integer

Es la cantidad de atributos que se descartaron. Los atributos se pueden descartar porque sus claves son demasiado largas o porque hay demasiados atributos. Si este valor es 0, todos los atributos son válidos.

AttributeValue

Son los tipos permitidos para [VALUE] en un atributo [KEY]:[VALUE].

Representación JSON
{

  // Union field value can be only one of the following:
  "stringValue": {
    object (TruncatableString)
  },
  "intValue": string,
  "boolValue": boolean
  // End of list of possible types for union field value.
}
Campos
Campo de unión value. Es el tipo de valor. value puede ser solo uno de los parámetros siguientes:
stringValue

object (TruncatableString)

Es una cadena de hasta 256 bytes de longitud.

intValue

string (int64 format)

Un número entero de 64 bits con firma.

boolValue

boolean

Es un valor booleano representado por true o false.