Package google.monitoring.v3

Índice

Ponto

Um único ponto de dados numa série cronológica.

Campos
interval

TimeInterval

O intervalo de tempo ao qual o ponto de dados se aplica. Para as métricas GAUGE, a hora de início é opcional, mas, se for fornecida, tem de ser igual à hora de fim. Para as métricas DELTA, a hora de início e de fim deve especificar um intervalo diferente de zero, com os pontos subsequentes a especificar intervalos contíguos e não sobrepostos. Para as métricas CUMULATIVE, a hora de início e de fim deve especificar um intervalo diferente de zero, com os pontos subsequentes a especificar a mesma hora de início e a aumentar as horas de fim, até que um evento repõe o valor cumulativo para zero e define uma nova hora de início para os pontos seguintes.

value

TypedValue

O valor do ponto de dados.

TimeInterval

Um intervalo de tempo que se estende imediatamente após uma hora de início até uma hora de fim. Se a hora de início for igual à hora de fim, o intervalo representa um único ponto no tempo.

Campos
end_time

Timestamp

Obrigatório. O fim do intervalo de tempo.

start_time

Timestamp

Opcional. O início do intervalo de tempo. O valor predefinido da hora de início é a hora de fim. A hora de início não pode ser posterior à hora de fim.

TimeSeries

Uma coleção de pontos de dados que descreve os valores variáveis ao longo do tempo de uma métrica. Uma série cronológica é identificada por uma combinação de um recurso monitorizado totalmente especificado e uma métrica totalmente especificada. Este tipo é usado para listar e criar séries cronológicas.

Campos
metric

Metric

A métrica associada. Uma métrica totalmente especificada usada para identificar a série temporal.

resource

MonitoredResource

O recurso monitorizado associado. As métricas personalizadas só podem usar determinados tipos de recursos monitorizados nos respetivos dados de séries cronológicas. Para mais informações, consulte o artigo Recursos monitorizados para métricas personalizadas.

metadata

MonitoredResourceMetadata

Apenas saída. Os metadados do recurso monitorizado associado. Ao ler uma série cronológica, este campo inclui etiquetas de metadados que são explicitamente denominadas na redução. Ao criar uma série cronológica, este campo é ignorado.

metric_kind

MetricKind

O tipo de métrica da série cronológica. Quando listar intervalos temporais, este tipo de métrica pode ser diferente do tipo de métrica da métrica associada se este intervalo temporal for um alinhamento ou uma redução de outros intervalos temporais.

Ao criar uma série cronológica, este campo é opcional. Se estiver presente, tem de ser igual ao tipo de métrica da métrica associada. Se o descritor da métrica associada tiver de ser criado automaticamente, este campo especifica o tipo de métrica do novo descritor e tem de ser GAUGE (o valor predefinido) ou CUMULATIVE.

value_type

ValueType

O tipo de valor da série cronológica. Quando lista séries cronológicas, este tipo de valor pode ser diferente do tipo de valor da métrica associada se esta série cronológica for um alinhamento ou uma redução de outras séries cronológicas.

Ao criar uma série cronológica, este campo é opcional. Se estiver presente, tem de ser igual ao tipo de dados no campo points.

points[]

Point

Os pontos de dados desta série temporal. Quando lista séries cronológicas, os pontos são devolvidos na ordem cronológica inversa.

Quando criar uma série cronológica, este campo tem de conter exatamente um ponto e o tipo do ponto tem de ser igual ao tipo de valor da métrica associada. Se o descritor da métrica associada tiver de ser criado automaticamente, o tipo de valor do descritor é determinado pelo tipo do ponto, que tem de ser BOOL, INT64, DOUBLE ou DISTRIBUTION.

unit

string

As unidades em que o valor da métrica é comunicado. Só é aplicável se o value_type for INT64, DOUBLE ou DISTRIBUTION. O elemento unit define a representação dos valores das métricas armazenados. Este campo só pode ser alterado através de CreateTimeSeries quando está vazio.

description

string

Apenas entrada. Uma descrição detalhada da série cronológica que vai ser associada ao google.api.MetricDescriptor para a métrica. Depois de definido, não é possível alterar este campo através de CreateTimeSeries.

TypedValue

Um único valor fortemente tipado.

Campos
Campo de união value. O campo de valor introduzido. value só pode ser uma das seguintes opções:
bool_value

bool

Um valor booleano: true ou false.

int64_value

int64

Um número inteiro de 64 bits. O respetivo intervalo é de aproximadamente ±9,2 x 1018.

double_value

double

Um número de vírgula flutuante de precisão dupla de 64 bits. A sua magnitude é de aproximadamente ±10±300 e tem 16 algarismos significativos de precisão.

string_value

string

Um valor de string de comprimento variável.

distribution_value

Distribution

Um valor de distribuição.