Package google.api

Indeks

Distribusi

Distribution berisi statistik ringkasan untuk populasi nilai. Secara opsional, histogram berisi histogram yang mewakili distribusi nilai-nilai tersebut di seluruh set bucket.

Statistik ringkasan adalah jumlah, rerata, jumlah deviasi kuadrat dari rerata, minimum, dan maksimum kumpulan nilai populasi. Histogram didasarkan pada urutan bucket dan memberikan jumlah nilai yang jatuh ke dalam setiap bucket. Batas bucket diberikan secara eksplisit atau oleh formula untuk bucket dengan lebar tetap atau yang meningkat secara eksponensial.

Meskipun tidak dilarang, umumnya tidak disarankan untuk menyertakan nilai yang tidak terbatas (tak terbatas atau NaN) dalam populasi nilai, karena ini akan merender kolom mean dan sum_of_squared_deviation menjadi tidak bermakna.

Kolom
count

int64

Jumlah nilai dalam populasi. Tidak boleh negatif. Nilai ini harus sama dengan jumlah nilai di bucket_counts jika histogram disediakan.
mean

double

Rata-rata aritmatika dari nilai-nilai dalam populasi. Jika count adalah nol, maka kolom ini harus nol.
sum_of_squared_deviation

double

Jumlah deviasi kuadrat dari rerata nilai dalam populasi. Untuk nilai x_i, ini adalah:

Sum[i=1..n]((x_i - mean)^2)

Knuth, "The Art of Computer Programming", Vol. 2, halaman 232, edisi 3 menjelaskan metode Welford untuk mengumpulkan jumlah ini dalam satu pass.

Jika count adalah nol, maka kolom ini harus nol.
range

Range

Jika ditentukan, berisi rentang nilai populasi. Kolom ini tidak boleh ada jika count adalah nol.
bucket_options

BucketOptions

Menentukan batas bucket histogram. Jika distribusi tidak berisi histogram, hapus kolom ini.
bucket_counts[]

int64

Jumlah nilai dalam setiap bucket histogram, seperti yang dijelaskan dalam bucket_options. Jika distribusi tidak memiliki histogram, hapus kolom ini. Jika ada histogram, jumlah nilai dalam bucket_counts harus sama dengan nilai di kolom count distribusi.

Jika ada, bucket_counts harus berisi nilai N, dengan N adalah jumlah bucket yang ditentukan di bucket_options. Jika Anda memberikan kurang dari nilai N, nilai yang tersisa dianggap 0.

Urutan nilai dalam bucket_counts mengikuti skema penomoran bucket yang dijelaskan untuk ketiga jenis bucket. Nilai pertama harus merupakan jumlah untuk bucket underflow (nomor 0). Nilai N-2 berikutnya adalah jumlah untuk bucket terbatas (nomor 1 hingga N-2). Nilai N di bucket_counts adalah jumlah untuk bucket tambahan (nomor N-1).
exemplars[]

Exemplar

Harus dalam urutan peningkatan kolom value.

BucketOptions

BucketOptions menjelaskan batas bucket yang digunakan untuk membuat histogram untuk distribusi. Bucket dapat berada dalam urutan linear, urutan eksponensial, atau setiap bucket dapat ditentukan secara eksplisit. BucketOptions tidak mencakup jumlah nilai di setiap bucket.

Bucket memiliki batas bawah inklusif dan batas atas eksklusif untuk nilai yang dihitung untuk bucket tersebut. Batas atas bucket harus benar-benar lebih besar dari batas bawah. Urutan N bucket untuk distribusi terdiri dari bucket underflow (angka 0), bucket dengan nol atau beberapa terbatas (nomor 1 sampai N - 2) dan bucket luapan (nomor N - 1). Bucket berdekatan: batas bawah bucket i (i > 0) sama dengan batas atas bucket i - 1. Bucket mencakup seluruh rentang nilai terbatas: batas bawah bucket underflow adalah -tak terhingga dan batas atas bucket overflow adalah +tak terhingga. Bucket terbatas disebut karena kedua batas bersifat terbatas.

Kolom
Kolom union options. Tepat satu dari ketiga kolom ini yang harus ditetapkan. options hanya ada berupa salah satu diantara berikut:
linear_buckets

Linear

Bucket linear.
exponential_buckets

Exponential

Bucket eksponensial.
explicit_buckets

Explicit

Bucket eksplisit.

Eksplisit

Menentukan kumpulan bucket dengan lebar arbitrer.

Ada size(bounds) + 1 (= N) bucket. Bucket i memiliki batas berikut:

Batas atas (0 <= i < N-1): batas[i] Batas bawah (1 <= i < N); batas[i - 1]

Kolom bounds harus berisi setidaknya satu elemen. Jika bounds hanya memiliki satu elemen, maka tidak ada bucket terbatas, dan satu elemen tersebut adalah batas umum bucket luapan dan aliran bawah.

Kolom
bounds[]

double

Nilai harus meningkat secara monoton.

Eksponensial

Menentukan urutan eksponensial bucket yang memiliki lebar yang proporsional dengan nilai batas bawah. Setiap bucket mewakili ketidakpastian relatif yang konstan terhadap nilai tertentu dalam bucket.

Ada num_finite_buckets + 2 (= N) bucket. Bucket i memiliki batas berikut:

Batas atas (0 <= i < N-1): skala * (faktor_pertumbuhan ^ i).

Batas bawah (1 <= i < N): skala * (growth_factor ^ (i - 1)).

Kolom
num_finite_buckets

int32

Harus lebih besar dari 0.
growth_factor

double

Harus lebih besar dari 1.
scale

double

Harus lebih besar dari 0.

Linear

Menentukan urutan linear bucket yang semuanya memiliki lebar yang sama (kecuali overflow dan underflow). Setiap bucket merepresentasikan ketidakpastian absolut yang konstan terkait nilai tertentu dalam bucket.

Ada num_finite_buckets + 2 (= N) bucket. Bucket i memiliki batas berikut:

Batas atas (0 <= i < N-1): offset + (lebar * i).

Batas bawah (1 <= i < N): offset + (lebar * (i - 1)).

Kolom
num_finite_buckets

int32

Harus lebih besar dari 0.
width

double

Harus lebih besar dari 0.
offset

double

Batas bawah bucket pertama.

Contoh

Contoh adalah titik contoh yang dapat digunakan untuk membuat anotasi nilai distribusi gabungan. Objek ini adalah metadata yang memberikan informasi tentang nilai tertentu yang ditambahkan ke bucket Distribusi, seperti ID trace yang aktif saat nilai ditambahkan. File ini dapat berisi informasi lebih lanjut, seperti nilai contoh dan stempel waktu, asal, dll.

Kolom
value

double

Nilai titik contoh. Nilai ini menentukan di bucket mana contoh tersebut berada.
timestamp

Timestamp

Waktu pengamatan (pengambilan sampel) nilai di atas.
attachments[]

Any

Informasi kontekstual tentang nilai contoh. Contohnya antara lain:

Rekaman aktivitas: type.googleapis.com/google.monitoring.v3.SpanContext

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

Label dihapus selama agregasi: type.googleapis.com/google.monitoring.v3.DroppedLabels

Mungkin hanya ada satu lampiran dari setiap jenis pesan dalam contoh tunggal, dan ini ditegakkan oleh sistem.

Rentang

Rentang nilai populasi.

Kolom
min

double

Nilai minimum populasi.
max

double

Nilai maksimum dari nilai populasi.

MetricDescriptor

Jenis ini tidak memiliki kolom.

Menentukan jenis metrik dan skemanya. Setelah deskriptor metrik dibuat, menghapus atau mengubahnya akan menghentikan pengumpulan data dan membuat data yang ada pada jenis metrik tidak dapat digunakan.

MetricKind

Jenis pengukuran. Hal ini menjelaskan bagaimana data dilaporkan. Untuk informasi tentang cara menetapkan waktu mulai dan waktu berakhir berdasarkan MetricKind, lihat [TimeInterval][google.monitoring.v3.TimeInterval].

Enum
METRIC_KIND_UNSPECIFIED Jangan gunakan nilai default ini.
GAUGE Pengukuran nilai seketika.
DELTA Perubahan nilai selama interval waktu.
CUMULATIVE Nilai yang terakumulasi selama interval waktu. Pengukuran kumulatif dalam deret waktu harus memiliki waktu mulai dan waktu berakhir yang sama, hingga peristiwa mereset nilai kumulatif ke nol dan menetapkan waktu mulai baru untuk titik berikut.

ValueType

Jenis nilai metrik.

Enum
VALUE_TYPE_UNSPECIFIED Jangan gunakan nilai default ini.
BOOL Nilainya adalah boolean. Jenis nilai ini hanya dapat digunakan jika jenis metrik adalah GAUGE.
INT64 Nilainya adalah bilangan bulat 64-bit bertanda.
DOUBLE Nilainya adalah bilangan floating point presisi ganda.
STRING Nilainya adalah {i>string<i} teks. Jenis nilai ini hanya dapat digunakan jika jenis metrik adalah GAUGE.
DISTRIBUTION Nilainya adalah Distribution.
MONEY Nilainya adalah uang.