BillingView

Mensagem para informar solicitações de faturamento pelo Eventstream.

Representação JSON 
{
  "reportRequests": [
    {
      object (ReportRequest)
    }
  ]
}
Campos
reportRequests[]

object (ReportRequest)

Solicitações de faturamento a serem informadas para cloud.eventstream.v2.ResourceEvent

ReportRequest

Mensagem de solicitação para o método "services.report".

Representação JSON 
{
  "serviceName": string,
  "operations": [
    {
      object (Operation)
    }
  ],
  "serviceConfigId": string
}
Campos
serviceName

string

O nome do serviço, conforme especificado na configuração dele. Por exemplo, "pubsub.googleapis.com"

Consulte google.api.Service para a definição de um nome de serviço.
operations[]

object (Operation)

Operações a serem informadas.

Normalmente, o serviço informa uma operação por solicitação. É permitido colocar várias operações em uma única solicitação, mas isso só deve ser feito quando várias operações estão naturalmente disponíveis no momento do relatório.

Não há limite para o número de operações na mesma ReportRequest, mas o tamanho dela não pode ser maior que 1 MB. Consulte ReportResponse.report_errors para saber mais sobre o comportamento de falha parcial.
serviceConfigId

string

Especifica qual versão da configuração de serviço deve ser usada para processar a solicitação.

Se não for especificado ou se nenhuma versão correspondente for encontrada, a mais recente será usada.

Operação

Representa informações sobre uma operação.

Representação 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

Identidade da operação. Precisa ser exclusivo no escopo do serviço que gerou a operação. Se o serviço chamar services.check() e services.report() na mesma operação, as duas chamadas precisarão ter o mesmo ID.

A versão 4 do UUID é recomendada, mas não obrigatória. Em cenários em que uma operação é calculada com base em informações existentes e um ID idempotente é desejável para fins de remoção de duplicação, a versão 5 do UUID é recomendada. Consulte a RFC 4122 para mais detalhes.
operationName

string

Nome totalmente qualificado da operação. Reservado para uso futuro.
consumerId

string

Identidade do consumidor que está usando o serviço. Esse campo deve ser preenchido para as operações iniciadas por um consumidor, mas não para as operações iniciadas pelo serviço que não estão relacionadas a um consumidor específico.

  • Pode estar em um dos seguintes formatos:
    • project:PROJECT_ID,
    • project_number:PROJECT_NUMBER,
    • projects/PROJECT_ID ou PROJECT_NUMBER,
    • folders/FOLDER_NUMBER,
    • organizations/ORGANIZATION_NUMBER,
    • api_key:API_KEY.
startTime

string (Timestamp format)

Obrigatório. Horário de início da operação.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Horário de término da operação. Obrigatório quando a operação é usada em ServiceController.Report, mas opcional quando é usada em ServiceController.Check.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Rótulos que descrevem a operação. Somente os seguintes rótulos são permitidos:

  • Rótulos que descrevem recursos monitorados conforme definido na configuração do serviço.
  • Rótulos padrão de valores de métricas. Quando especificados, os rótulos definidos no valor da métrica substituem esses padrões.
  • Os seguintes rótulos definidos pelo Google Cloud Platform:
    • cloud.googleapis.com/location descrevendo o local em que a operação aconteceu,
    • servicecontrol.googleapis.com/userAgent descrevendo o user agent da solicitação de API,
    • servicecontrol.googleapis.com/service_agent descrevendo o serviço usado para processar a solicitação de API (por exemplo, ESP),
    • servicecontrol.googleapis.com/platform descrevendo a plataforma em que a API é veiculada, como App Engine, Compute Engine ou Kubernetes Engine.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
metricValueSets[]

object (MetricValueSet)

Representa informações sobre esta operação. Cada MetricValueSet corresponde a uma métrica definida na configuração do serviço. O tipo de dados usado no MetricValueSet precisa corresponder ao tipo especificado na definição da métrica.

Em uma única operação, não é permitido ter mais de uma instância de MetricValue com os mesmos nomes de métricas e combinações idênticas de valores de rótulo. Se uma solicitação tiver essas instâncias duplicadas de MetricValue, ela será rejeitada com um erro de argumento inválido.
logEntries[]

object (LogEntry)

Representa informações a serem registradas.
quotaProperties

object (QuotaProperties)

Representa as propriedades necessárias para a verificação de cota. Aplicável apenas se esta operação for uma solicitação de verificação de cota. Se não for especificado, nenhuma verificação de cota será realizada.
importance

enum (Importance)

NÃO USE. Este é um campo experimental.
userLabels

map (key: string, value: string)

Pré-lançamento particular. Esse recurso está disponível apenas para serviços aprovados.

Rótulos definidos pelo usuário para o recurso associado a esta operação.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
resources[]

object (ResourceInfo)

Os recursos envolvidos na operação. O número máximo de entradas aceitas nesse campo é 100.
traceSpans[]

object (TraceSpan)

Não implementado. Uma lista de períodos do Cloud Trace. Os nomes de extensão precisam conter o ID do projeto de destino, que pode ser o projeto do produtor ou do consumidor.

MetricValueSet

Representa um conjunto de valores de métricas na mesma métrica. Cada valor de métrica no conjunto precisa ter uma combinação exclusiva de horário de início, horário de término e valores de rótulo.

Representação JSON 
{
  "metricName": string,
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
Campos
metricName

string

O nome da métrica definido na configuração do serviço.
metricValues[]

object (MetricValue)

Os valores dessa métrica.

MetricValue

Representa um único valor de métrica.

Representação 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)

Os rótulos que descrevem o valor da métrica. Consulte os comentários em google.api.servicecontrol.v1.Operation.labels para conferir a relação substituta. Esse mapa não pode conter rótulos de recursos monitorados.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
startTime

string (Timestamp format)

O início do período em que a medição do valor da métrica é aplicada. O período tem semânticas diferentes para diferentes tipos de métricas (cumulativa, delta e medidor). Consulte a documentação de definição de métricas na configuração do serviço para mais detalhes. Se não for especificado, google.api.servicecontrol.v1.Operation.start_time será usado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

O fim do período em que a medição do valor da métrica é aplicada. Se não for especificado, google.api.servicecontrol.v1.Operation.end_time será usado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
Campo de união value. O valor. O tipo de valor usado na solicitação precisa corresponder à definição de métrica na configuração do serviço. Caso contrário, o MetricValue será rejeitado. value pode ser apenas de um dos tipos a seguir:
boolValue

boolean

Um valor booleano.
int64Value

string (int64 format)

Um valor inteiro assinado de 64 bits.
doubleValue

number

Um pontuação flutuante de precisão dupla.
stringValue

string

Um valor de string de texto.
distributionValue

object (Distribution)

Um valor de distribuição.
moneyValue

object (Money)

Um valor monetário.

Distribuição

A distribuição representa uma distribuição de frequência de pontos de amostra de valor duplo. Ele contém o tamanho da população de pontos de amostra mais outras informações opcionais:

  • a média aritmética das amostras
  • o mínimo e o máximo das amostras
  • o desvio quadrático da soma das amostras, usado para calcular a variância
  • um histograma dos valores dos pontos de amostra
Representação 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)

O número total de amostras na distribuição. Precisa ser >= 0.
mean

number

A média aritmética das amostras na distribuição. Se count for zero, esse campo precisará ser zero.
minimum

number

O mínimo da população de valores. Ignorado se count for zero.
maximum

number

O máximo da população de valores. Ignorado se count for zero.
sumOfSquaredDeviation

number

A soma dos desvios ao quadrado da média: Sum[i=1..count]((x_i - mean)^2), em que cada x_i é um valor de amostra. Se count for zero, esse campo precisará ser zero. Caso contrário, a validação da solicitação vai falhar.
bucketCounts[]

string (int64 format)

O número de amostras em cada bucket de histograma. bucketCounts são opcionais. Se estiverem presentes, eles precisam somar o valor count.

Os intervalos são definidos abaixo em bucket_option. Há N buckets. bucketCounts[0] é o número de amostras no bucket de subfluxo. bucketCounts[1] a bucketCounts[N-1] são os números de amostras em cada um dos buckets finitos. e bucketCounts[N] é o número de amostras no bucket de estouro. Confira os comentários de bucket_option abaixo para mais detalhes.

Qualquer sufixo de zeros à direita pode ser omitido.
exemplars[]

object (Exemplar)

Exemplos de pontos. Precisa estar em ordem crescente do campo value.

Campo de união bucket_option. Define os buckets no histograma. bucket_option e bucket_counts precisam ser definidos ou não definidos.

Os buckets são numerados no intervalo [0, N], com um total de N+1 buckets. É preciso haver pelo menos dois agrupamentos. Um histograma de agrupamento único não fornece informações que já não são fornecidas por count.

O primeiro bucket é o de subfluxo, que tem um limite inferior de -inf. O último bucket é o de sobrefluxo, que tem um limite superior de +inf. Todos os outros buckets (se houver) são chamados de "finitos" porque têm limites inferiores e superiores finitos. Conforme descrito abaixo, há três maneiras de definir os intervalos finitos.

(1) Buckets com largura constante. (2) Buckets com larguras exponencialmente crescentes. (3) Intervalos com larguras arbitrárias fornecidas pelo usuário.

Em todos os casos, os intervalos abrangem toda a reta numérica real (-inf, +inf). Os limites superiores dos intervalos são exclusivos, e os inferiores são inclusivos. O limite superior do bucket de subfluxo é igual ao limite inferior do menor bucket finito. O limite inferior do bucket de sobrefluxo é igual ao limite superior do maior bucket finito. bucket_option pode ser apenas de um dos tipos a seguir:
linearBuckets

object (LinearBuckets)

Buckets com largura constante.
exponentialBuckets

object (ExponentialBuckets)

Buckets com largura exponencialmente crescente.
explicitBuckets

object (ExplicitBuckets)

Intervalos com largura arbitrária fornecida pelo usuário.

LinearBuckets

Descrevendo buckets com largura constante.

Representação JSON 
{
  "numFiniteBuckets": integer,
  "width": number,
  "offset": number
}
Campos
numFiniteBuckets

integer

O número de intervalos finitos. Com os buckets de subfluxo e sobrefluxo, o número total de buckets é numFiniteBuckets + 2. Consulte os comentários em bucketOptions para mais detalhes.
width

number

O i-ésimo bucket linear cobre o intervalo [offset + (i-1) * width, offset + i * width), em que i varia de 1 a numFiniteBuckets, inclusive. Precisa ser estritamente positivo.
offset

number

O i-ésimo bucket linear cobre o intervalo [offset + (i-1) * width, offset + i * width), em que i varia de 1 a numFiniteBuckets, inclusive.

ExponentialBuckets

Descrevendo buckets com largura exponencialmente crescente.

Representação JSON 
{
  "numFiniteBuckets": integer,
  "growthFactor": number,
  "scale": number
}
Campos
numFiniteBuckets

integer

O número de intervalos finitos. Com os buckets de subfluxo e sobrefluxo, o número total de buckets é numFiniteBuckets + 2. Consulte os comentários em bucketOptions para mais detalhes.
growthFactor

number

O i-ésimo bucket exponencial abrange o intervalo [escala * fatorDeCrescimento^(i-1), escala * fatorDeCrescimento^i), em que i varia de 1 a numFiniteBuckets, inclusive. Precisa ser maior que 1,0.
scale

number

O i-ésimo bucket exponencial abrange o intervalo [escala * fatorDeCrescimento^(i-1), escala * fatorDeCrescimento^i), em que i varia de 1 a numFiniteBuckets, inclusive. Precisa ser maior que 0.

ExplicitBuckets

Descrevendo buckets com largura arbitrária fornecida pelo usuário.

Representação JSON 
{
  "bounds": [
    number
  ]
}
Campos
bounds[]

number

"bound" é uma lista de limites estritamente crescentes entre buckets. Uma lista de comprimento N-1 define N buckets devido ao fenceposting. Consulte os comentários em bucketOptions para mais detalhes.

O bucket finito i-ésimo cobre o intervalo [bound[i-1], bound[i]), em que i varia de 1 a bound_size() - 1. Não há buckets finitos se "bound" contiver apenas um elemento. Nesse caso especial, o único limite define a fronteira entre os buckets de subfluxo e sobrefluxo.

bucket number lower bound upper bound i == 0 (underflow) -inf bound[i] 0 < i < bound_size() bound[i-1] bound[i] i == bound_size() (overflow) bound[i-1] +inf

Exemplar

Exemplos são pontos de exemplo que podem ser usados para anotar valores de distribuição agregados. Eles são metadados que fornecem informações sobre um valor específico adicionado a um bucket de distribuição, como um ID de trace ativo quando um valor foi adicionado. Eles podem conter mais informações, como valores de exemplo, carimbos de data/hora, origem etc.

Representação JSON 
{
  "value": number,
  "timestamp": string,
  "attachments": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Campos
value

number

Valor do ponto do exemplo. Esse valor determina a qual bucket o exemplo pertence.
timestamp

string (Timestamp format)

O horário de observação (amostragem) do valor acima.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
attachments[]

object

Informações contextuais sobre o valor de exemplo. Os exemplos são:

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

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

Rótulos descartados durante a agregação: type.googleapis.com/google.monitoring.v3.DroppedLabels

Pode haver apenas um anexo de qualquer tipo de mensagem em um único exemplo, e isso é aplicado pelo sistema.

Um objeto contendo campos de um tipo arbitrário. Um campo adicional "@type" contém uma URI que identifica o tipo. Exemplo: { "id": 1234, "@type": "types.example.com/standard/id" }.

Dinheiro

Representa um montante em dinheiro com o respectivo tipo de moeda.

Representação JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Campos
currencyCode

string

O código de moeda de três letras definido no ISO 4217.
units

string (int64 format)

As unidades inteiras do montante. Por exemplo, se currencyCode for "USD", então 1 unidade equivalerá a um dólar americano.
nanos

integer

Número de unidades nano (10^-9) do montante. É necessário que o valor fique entre -999.999.999 e +999.999.999 (inclusive os dois limites). Se units for positivo, nanos será positivo ou zero. Se units for zero, nanos poderá ser positivo, zero ou negativo. Se units for negativo, nanos será negativo ou zero. Por exemplo,US $-1,75 é representado como units=-1 e nanos=-750.000.000.

LogEntry

Uma entrada de registro individual.

Representação 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

Obrigatório. O registro a que esta entrada de registro pertence. Exemplos: "syslog", "book_log".
timestamp

string (Timestamp format)

A hora em que o evento descrito pela entrada de registro ocorreu. Se omitido, o padrão será o horário de início da operação.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
severity

enum (LogSeverity)

A gravidade da entrada de registro. O valor padrão é LogSeverity.DEFAULT.
httpRequest

object (HttpRequest)

Opcional. Informações sobre a solicitação HTTP associada a esta entrada de registro, se aplicável.
trace

string

Opcional. O nome do recurso do trace associado à entrada de registro, se houver. Se esse campo contiver um nome de recurso relativo, considere que o nome é relativo a //tracing.googleapis.com. Exemplo: projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824
insertId

string

Um ID exclusivo da entrada de registro usado para remoção de duplicações. Se omitido, a implementação vai gerar um com base em operationId.
labels

map (key: string, value: string)

Um conjunto de dados (chave, valor) definidos pelo usuário que fornecem mais informações sobre a entrada de registro.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
operation

object (LogEntryOperation)

Opcional. Informações sobre uma operação associada à entrada de registro, se aplicável.
sourceLocation

object (LogEntrySourceLocation)

Opcional. Informações do local do código-fonte associadas à entrada de registro, se houver.
Campo de união payload. O payload da entrada de registro, que pode ser de vários tipos. payload pode ser apenas de um dos tipos a seguir:
protoPayload

object

O payload da entrada de registro, representado como um buffer de protocolo expresso como um objeto JSON. No momento, o único tipo aceito é AuditLog.

Um objeto contendo campos de um tipo arbitrário. Um campo adicional "@type" contém uma URI que identifica o tipo. Exemplo: { "id": 1234, "@type": "types.example.com/standard/id" }.
textPayload

string

O payload da entrada de registro, representado como uma string Unicode (UTF-8).
structPayload

object (Struct format)

O payload da entrada de registro, representado como uma estrutura expressa como um objeto JSON.

HttpRequest

Um proto comum para registrar solicitações HTTP. Contém apenas semântica definida pela especificação HTTP. As informações de registro específicas do produto PRECISAM ser definidas em uma mensagem separada.

Representação 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

O método de solicitação. Exemplos: "GET", "HEAD", "PUT", "POST".
requestUrl

string

O esquema (http, https), o nome do host, o caminho e a parte da consulta do URL solicitado. Exemplo: "http://example.com/some/info?color=red".
requestSize

string (int64 format)

O tamanho da mensagem de solicitação HTTP em bytes, incluindo os cabeçalhos e o corpo da solicitação.
status

integer

O código de resposta que indica o status da resposta. Exemplos: 200, 404.
responseSize

string (int64 format)

O tamanho da mensagem de resposta HTTP enviada de volta ao cliente, em bytes, incluindo os cabeçalhos e o corpo da resposta.
userAgent

string

O user agent enviado pelo cliente. Exemplo: "Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)".
remoteIp

string

O endereço IP (IPv4 ou IPv6) do cliente que emitiu a solicitação HTTP. Exemplos: "192.168.1.1", "FE80::0202:B3FF:FE1E:8329".
serverIp

string

O endereço IP (IPv4 ou IPv6) do servidor de origem para onde a solicitação foi enviada.
referer

string

O URL referenciador da solicitação, conforme definido em Definições de campos de cabeçalho HTTP/1.1.
latency

string (Duration format)

A latência de processamento da solicitação no servidor, desde o momento em que a solicitação foi recebida até o envio da resposta.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
cacheLookup

boolean

Se uma pesquisa de cache foi tentada ou não.
cacheHit

boolean

Se uma entidade foi veiculada do cache (com ou sem validação).
cacheValidatedWithOriginServer

boolean

Se a resposta foi validada com o servidor de origem antes de ser veiculada do cache. Esse campo só é relevante se cacheHit for "True".
cacheFillBytes

string (int64 format)

O número de bytes de resposta HTTP inseridos no cache. Definido apenas quando uma tentativa de preenchimento do cache foi feita.
protocol

string

Protocolo usado para a solicitação. Exemplos: "HTTP/1.1", "HTTP/2", "websocket"

LogEntryOperation

Informações adicionais sobre uma operação potencialmente de longa duração a que uma entrada de registro está associada.

Representação JSON 
{
  "id": string,
  "producer": string,
  "first": boolean,
  "last": boolean
}
Campos
id

string

Opcional. Um identificador de operação arbitrário. As entradas de registro com o mesmo identificador são consideradas parte da mesma operação.
producer

string

Opcional. Um identificador de produtor arbitrário. A combinação de id e producer precisa ser globalmente exclusiva. Exemplos para producer: "MyDivision.MyBigCompany.com", "github.com/MyProject/MyApplication".
first

boolean

Opcional. Defina como "True" se esta for a primeira entrada de registro na operação.
last

boolean

Opcional. Defina como "True" se esta for a última entrada de registro na operação.

LogEntrySourceLocation

Informações adicionais sobre o local do código-fonte que produziu a entrada de registro.

Representação JSON 
{
  "file": string,
  "line": string,
  "function": string
}
Campos
file

string

Opcional. Nome do arquivo de origem. Dependendo do ambiente de execução, pode ser um nome simples ou totalmente qualificado.
line

string (int64 format)

Opcional. Linha no arquivo de origem. Baseado em 1; 0 indica que não há número de linha disponível.
function

string

Opcional. Nome legível da função ou do método que está sendo invocado, com contexto opcional, como o nome da classe ou do pacote. Essas informações podem ser usadas em contextos como o visualizador de registros, em que um arquivo e um número de linha são menos significativos. O formato pode variar de acordo com o idioma. Por exemplo: qual.if.ied.Class.method (Java), dir/package.func (Go), function (Python).

QuotaProperties

Representa as propriedades necessárias para operações de cota.

Representação JSON 
{
  "quotaMode": enum (QuotaMode)
}
Campos
quotaMode

enum (QuotaMode)

Modo de cota para esta operação.

ResourceInfo

Descreve um recurso associado a esta operação.

Representação JSON 
{
  "resourceContainer": string,
  "resourceName": string,
  "resourceLocation": string,
  "permission": string
}
Campos
resourceContainer

string

O identificador do pai desta instância de recurso. Precisa estar em um dos seguintes formatos: - projects/<project-id or project-number> - folders/<folder-id> - organizations/<organization-id>
resourceName

string

Nome do recurso. Isso é usado para fins de auditoria.
resourceLocation

string

O local do recurso. Se não estiver vazio, o recurso será verificado de acordo com a política de local. O valor precisa ser uma zona, região ou multirregião válida. Por exemplo: "europe-west4" ou "northamerica-northeast1-a"
permission

string

A permissão de recurso necessária para esta solicitação.

TraceSpan

Um período representa uma única operação em um rastreamento. Os intervalos podem ser aninhados para formar uma árvore de rastreamento. Muitas vezes, um trace contém um período raiz que descreve a latência de ponta a ponta e um ou mais subperíodos para as suboperações. Um trace também pode conter vários intervalos raiz ou nenhum. Os intervalos não precisam ser contíguos. Pode haver lacunas ou sobreposições entre eles em um rastreamento.

Representação 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

O nome do recurso do período no seguinte formato:

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

[TRACE_ID] é um identificador exclusivo de um rastreamento em um projeto. É uma codificação hexadecimal de 32 caracteres de uma matriz de 16 bytes.

[SPAN_ID] é um identificador exclusivo de um período em um trace. É uma codificação hexadecimal de 16 caracteres de uma matriz de 8 bytes.
spanId

string

A parte [SPAN_ID] do nome do recurso do intervalo.
parentSpanId

string

O [SPAN_ID] do intervalo pai deste intervalo. Se for um intervalo raiz, esse campo vai estar vazio.
displayName

object (TruncatableString)

Uma descrição da operação do intervalo (até 128 bytes). O Stackdriver Trace mostra a descrição no Console do Google Cloud Platform. Por exemplo, o nome de exibição pode ser um nome de método qualificado ou um nome de arquivo e um número de linha em que a operação é chamada. Uma prática recomendada é usar o mesmo nome de exibição em um aplicativo e no mesmo ponto de chamada. Isso facilita a correlação de intervalos em diferentes rastreamentos.
startTime

string (Timestamp format)

O horário de início do intervalo. No lado do cliente, esse é o horário mantido pela máquina local em que a execução do intervalo começa. No lado do servidor, esse é o momento em que o manipulador de aplicativos do servidor começa a ser executado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

O horário de término do período. No lado do cliente, esse é o tempo mantido pela máquina local em que a execução do período termina. No lado do servidor, esse é o momento em que o manipulador de aplicativos do servidor para de ser executado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
attributes

object (Attributes)

Um conjunto de atributos no período. Você pode ter até 32 atributos por extensão.
status

object (Status)

Um status final opcional para esse intervalo.
sameProcessAsParentSpan

boolean

(Opcional) Defina esse parâmetro para indicar se o intervalo está no mesmo processo que o pai. Se você não definir esse parâmetro, o Stackdriver Trace não poderá aproveitar essas informações úteis.
childSpanCount

integer

Um número opcional de intervalos filhos gerados enquanto esse intervalo estava ativo. Se definido, permite que a implementação detecte intervalos de filhos ausentes.
spanKind

enum (SpanKind)

Distingue entre intervalos gerados em um contexto específico. Por exemplo, dois intervalos com o mesmo nome podem ser diferenciados usando CLIENT (chamador) e SERVER (chamado) para identificar uma chamada de RPC.

TruncatableString

Representa uma string que pode ser abreviada até um comprimento especificado.

Representação JSON 
{
  "value": string,
  "truncatedByteCount": integer
}
Campos
value

string

A string abreviada. Por exemplo, se a string original tiver 500 bytes e o limite for 128 bytes, value vai conter os primeiros 128 bytes da string de 500 bytes.

O truncamento sempre ocorre em um limite de caracteres UTF8. Se houver caracteres multibyte na string, o comprimento da string abreviada poderá ser menor que o limite de tamanho.
truncatedByteCount

integer

O número de bytes removidos da string original. Se esse valor for 0, a string não foi abreviada.

Atributos

Um conjunto de atributos, cada um no formato [KEY]:[VALUE].

Representação JSON 
{
  "attributeMap": {
    string: {
      object (AttributeValue)
    },
    ...
  },
  "droppedAttributesCount": integer
}
Campos
attributeMap

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

O conjunto de atributos. A chave de cada atributo pode ter até 128 bytes. O valor pode ser uma string de até 256 bytes, um número inteiro assinado de 64 bits ou os valores booleanos true e false. Exemplo:

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

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
droppedAttributesCount

integer

O número de atributos descartados. Os atributos podem ser descartados porque as chaves são muito longas ou porque há muitos atributos. Se esse valor for 0, todos os atributos serão válidos.

AttributeValue

Os tipos permitidos para [VALUE] em um atributo [KEY]:[VALUE].

Representação 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ão value. O tipo do valor. value pode ser apenas de um dos tipos a seguir:
stringValue

object (TruncatableString)

Uma string com até 256 bytes.
intValue

string (int64 format)

Um número inteiro assinado de 64 bits
boolValue

boolean

Um valor booleano representado por true ou false.