Package google.api

Index

Verteilung

Distribution enthält zusammenfassende Statistiken für eine Population von Werten. Optional enthält es ein Histogramm, das die Verteilung dieser Werte über eine Reihe von Buckets darstellt.

Die zusammenfassenden Statistiken sind die Anzahl, der Mittelwert, die Summe der quadratischen Abweichung vom Mittelwert, das Minimum und das Maximum der Population von Werten. Das Histogramm basiert auf einer Abfolge von Buckets und gibt die Anzahl der Werte an, die in jeden Bucket fallen. Die Grenzen der Buckets werden entweder explizit oder durch Formeln für Buckets mit fester oder exponentiell zunehmender Breite angegeben.

Obwohl es nicht verboten ist, ist es im Allgemeinen keine gute Idee, nicht endliche Werte (Unendlich oder NaNs) in die Wertepopulation aufzunehmen, da die Felder mean und sum_of_squared_deviation dadurch bedeutungslos werden.

Felder
count

int64

Die Anzahl der Werte in der Population Darf nicht negativ sein. Dieser Wert muss der Summe der Werte in bucket_counts entsprechen, wenn ein Histogramm angegeben wird.
mean

double

Das arithmetische Mittel der Werte in der Population Wenn count null ist, muss dieses Feld null sein.
sum_of_squared_deviation

double

Die Summe der quadratischen Abweichungen vom Mittelwert der Werte in der Population Für die Werte x_i lautet dies:

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

Knuth, "The Art of Computer Programming", Vol. 2, Seite 232, 3. Ausgabe beschreibt die Welford-Methode, um diese Summe in einem Durchlauf zu akkumulieren.

Wenn count null ist, muss dieses Feld null sein.
range

Range

Enthält den Bereich der Populationswerte, falls angegeben. Das Feld darf nicht vorhanden sein, wenn count null ist.
bucket_options

BucketOptions

Definiert die Grenzen des Histogramm-Buckets. Wenn die Verteilung kein Histogramm enthält, lassen Sie dieses Feld weg.
bucket_counts[]

int64

Die Anzahl der Werte in jedem Bucket des Histogramms, wie in bucket_options beschrieben. Wenn die Verteilung kein Histogramm hat, lassen Sie dieses Feld weg. Wenn ein Histogramm vorhanden ist, muss die Summe der Werte in bucket_counts mit dem Wert im Feld count der Verteilung übereinstimmen.

Falls vorhanden, sollte bucket_counts N Werte enthalten, wobei N die Anzahl der Buckets ist, die in bucket_options angegeben sind. Wenn Sie weniger als N Werte angeben, wird für die verbleibenden Werte von 0 ausgegangen.

Die Reihenfolge der Werte in bucket_counts folgt den Bucket-Nummerierungsschemas, die für die drei Bucket-Typen beschrieben werden. Der erste Wert muss die Anzahl für den Unterlauf-Bucket sein (Nummer 0). Die nächsten N-2-Werte sind die Anzahl für die endlichen Buckets (Nummer 1 bis N-2). Der n-te Wert in bucket_counts ist die Anzahl für den Überlauf-Bucket (Nummer N-1).
exemplars[]

Exemplar

Muss in aufsteigender Reihenfolge des Feldes value angegeben sein.

BucketOptions

BucketOptions beschreibt die Bucket-Grenzen, die zum Erstellen eines Histogramms für die Verteilung verwendet werden. Die Buckets können eine lineare oder exponentielle Abfolge haben oder jeder Bucket kann explizit angegeben werden. BucketOptions enthält nicht die Anzahl der Werte in jedem Bucket.

Ein Bucket hat eine inklusive Untergrenze und eine exklusive Obergrenze für die Werte, die für diesen Bucket gezählt werden. Die Obergrenze eines Buckets muss strikt größer als die Untergrenze sein. Die Abfolge von N Buckets für eine Verteilung besteht aus einem Unterlauf-Bucket (Nummer 0), null oder mehr endlichen Buckets (Nummer 1 bis N – 2) und einem Überlauf-Bucket (Nummer N – 1). Die Buckets sind zusammenhängend: Die Untergrenze von Bucket i (i > 0) ist mit der Obergrenze von Bucket i – 1 identisch. Die Buckets erstrecken sich über den gesamten Bereich der endlichen Werte: Die Untergrenze des Unterlauf-Buckets ist "-unendlich" und die Obergrenze des Überlauf-Buckets ist +unendlich. Die endlichen Buckets heißen so, weil beide Grenzen endlich sind.

Felder
Union-Feld options. Genau eines dieser drei Felder muss festgelegt werden. Für options ist nur einer der folgenden Werte zulässig:
linear_buckets

Linear

Der lineare Bucket.
exponential_buckets

Exponential

Die exponentiellen Buckets.
explicit_buckets

Explicit

Die expliziten Buckets

Explizit

Gibt eine Reihe von Buckets mit beliebiger Breite an.

Es gibt size(bounds) + 1 (= N) Buckets. Für den Bucket i gelten die folgenden Grenzwerte:

Obergrenze (0 <= i < N-1): bounds[i] Untergrenze (1 <= i < N); bounds[i – 1]

Das Feld bounds muss mindestens ein Element enthalten. Wenn bounds nur ein Element hat, gibt es keine endlichen Buckets. Dieses einzelne Element bildet dann die gemeinsame Grenze der Überlauf- und Unterlauf-Buckets.

Felder
bounds[]

double

Die Werte müssen kontinuierlich ansteigen.

Exponentiell

Gibt eine exponentielle Abfolge von Buckets an, deren Breite proportional zum Wert der Untergrenze ist. Jeder Bucket stellt eine konstante relative Unsicherheit bei einem bestimmten Wert im Bucket dar.

Es gibt num_finite_buckets + 2 (= N) Buckets. Für den Bucket i gelten die folgenden Grenzwerte:

Obergrenze (0 <= i < N-1): Skalierung * (growth_factor ^ i).

Untergrenze (1 <= i < N): Skalierung * (growth_factor ^ (i - 1)).

Felder
num_finite_buckets

int32

Muss größer als 0 sein.
growth_factor

double

Muss größer als 1 sein.
scale

double

Muss größer als 0 sein.

Linear

Gibt eine lineare Abfolge von Buckets an, die alle dieselbe Breite haben (außer Überlauf und Unterlauf). Jedes Bucket stellt eine konstante absolute Unsicherheit in Bezug auf den spezifischen Wert im Bucket dar.

Es gibt num_finite_buckets + 2 (= N) Buckets. Für den Bucket i gelten die folgenden Grenzwerte:

Obergrenze (0 <= i < N-1): offset + (Breite * i).

Untergrenze (1 <= i < N): Offset + (Breite * (i - 1)).

Felder
num_finite_buckets

int32

Muss größer als 0 sein.
width

double

Muss größer als 0 sein.
offset

double

Untergrenze des ersten Buckets.

Exemplar

Beispiele sind Beispielpunkte, mit denen aggregierte Verteilungswerte annotiert werden können. Sie sind Metadaten, die Informationen zu einem bestimmten Wert enthalten, der einem Verteilungs-Bucket hinzugefügt wurde, z. B. eine Trace-ID, die beim Hinzufügen eines Werts aktiv war. Sie können weitere Informationen enthalten, wie z. B. Beispielwerte und Zeitstempel, den Ursprung usw.

Felder
value

double

Wert des Beispielpunkts. Dieser Wert bestimmt, zu welchem Bucket das Beispiel gehört.
timestamp

Timestamp

Die Beobachtungszeit (Stichprobenzeit) des obigen Werts.
attachments[]

Any

Kontextbezogene Informationen zum Beispielwert. Beispiele:

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

Literalstring: type.googleapis.com/google.protobuf.StringValue

Bei der Aggregation verworfene Labels: type.googleapis.com/google.monitoring.v3.DroppedLabels

Es kann nur einen Anhang eines beliebigen Nachrichtentyps in einem einzelnen Beispiel geben, was vom System durchgesetzt wird.

Bereich

Der Bereich der Populationswerte.

Felder
min

double

Das Minimum der Populationswerte.
max

double

Das Maximum der Populationswerte.

MetricDescriptor

Dieser Typ hat keine Felder.

Definiert einen Messwerttyp und sein Schema. Nachdem ein Messwertdeskriptor erstellt wurde, wird durch das Löschen oder Ändern die Datenerfassung beendet und die vorhandenen Daten des Messwerttyps können nicht mehr verwendet werden.

MetricKind

Die Art der Messung. Es beschreibt, wie die Daten gemeldet werden. Informationen zum Festlegen von Start- und Endzeit basierend auf MetricKind finden Sie unter [TimeInterval][google.monitoring.v3.TimeInterval].

Enums
METRIC_KIND_UNSPECIFIED Verwenden Sie diesen Standardwert nicht.
GAUGE Eine sofortige Messung eines Werts.
DELTA Die Änderung eines Werts in einem Zeitintervall.
CUMULATIVE Ein Wert, der über ein Zeitintervall aggregiert wurde. Kumulative Messungen in einer Zeitachse sollten dieselbe Startzeit und zunehmende Endzeiten haben, bis ein Ereignis den kumulativen Wert auf null setzt und eine neue Startzeit für die folgenden Punkte festlegt.

ValueType

Der Werttyp eines Messwerts.

Enums
VALUE_TYPE_UNSPECIFIED Verwenden Sie diesen Standardwert nicht.
BOOL Der Wert ist ein boolescher Wert. Dieser Werttyp kann nur verwendet werden, wenn der Messwerttyp GAUGE ist.
INT64 Der Wert ist eine vorzeichenbehaftete 64-Bit-Ganzzahl.
DOUBLE Der Wert ist eine Gleitkommazahl mit doppelter Genauigkeit.
STRING Der Wert ist ein Textstring. Dieser Werttyp kann nur verwendet werden, wenn der Messwerttyp GAUGE ist.
DISTRIBUTION Der Wert ist ein Distribution.
MONEY Der Wert ist Geld.