Werttypen und Messwertarten

In der Erläuterung des Messwertmodells werden im Abschnitt Messwerttypen allgemein die Attribute erläutert, die einen Messwerttyp beschreiben. In diesem Abschnitt werden zwei dieser Attribute ausführlicher erläutert:

  • Werttyp
  • Messwertart

Werttyp

Der Werttyp ist der Datentyp für die Messungen. Jede Zeitachse zeichnet den Werttyp (Typ ValueType) für die zugehörigen Datenpunkte auf.

  • Bei Messungen, die jeweils aus einem einzelnen Wert bestehen, wie boolesche Werte und numerische Daten, gibt der Werttyp an, wie die Daten gespeichert werden:

    • Boolesche Variable BOOL
    • INT64, eine 64-Bit-Ganzzahl
    • DOUBLE, eine Gleitkommazahl mit doppelter Genauigkeit
    • STRING, einen String

  • Bei Verteilungsmesswerten ist der Wert kein einzelner Wert, sondern eine Gruppe von Werten. Der Werttyp für Verteilungsmesswerte ist DISTRIBUTION.

    Eine Verteilung enthält Statistiken, die eine Gruppe von Werten zusammenfassen. Die Werte in einer Verteilung enthalten den Mittelwert, die Anzahl, den Höchstwert und andere Statistiken, die für eine Gruppe von Werten berechnet wurden. Eine Verteilung kann auch ein Histogramm enthalten, das darstellt, wie die Werte über einen Satz von Bereichen verteilt sind.

    Latenzmesswerte erfassen Daten in der Regel als Verteilungen. Weitere Informationen zu Verteilungen finden Sie auf der Referenzseite Distribution. Informationen zum Diagramm für diese Messwerte finden Sie unter Verteilungsmesswerte.

Messwertart

Jede Zeitachse enthält die Messwertart (Typ MetricKind) für ihre Datenpunkte. Die Art der Messwertdaten gibt an, wie die Werte relativ zueinander interpretiert werden. Es gibt drei Arten von Cloud Monitoring-Messwerten:

  • Ein gauge -Messwert, in dem der Wert einen bestimmten Zeitpunkt misst. Messwerte, die die CPU-Auslastung messen, sind beispielsweise Messwerte. Jeder Punkt zeichnet die CPU-Auslastung zum Zeitpunkt der Messung auf. Ein weiteres Beispiel für einen Messwert ist die aktuelle Temperatur.

  • Ein Delta-Messwert, bei dem der Wert die Änderung in einem Zeitintervall misst. Bei Lesevorgängen ist das Zeitintervall zur Hälfte offen. Die Startzeit wird dabei nicht berücksichtigt, die Endzeit jedoch eingeschlossen: (startTime, endTime]. Messwerte, mit denen die Anzahl der Anfragen gemessen wird, sind beispielsweise Deltamesswerte. Jeder Wert erfasst, wie viele Anfragen nach der Startzeit bis einschließlich der Endzeit eingegangen sind.

  • Ein kumulativer Messwert, bei dem sich der Wert im Laufe der Zeit kontinuierlich erhöht. Beispielsweise kann ein Messwert für "gesendete Byte" kumulativ sein. Jeder Wert zeichnet die Gesamtzahl der Byte auf, die zu diesem Zeitpunkt von einem Dienst gesendet wurden.

Unterstützte Kombinationen

Nicht alle Kombinationen aus Messwerttyp und Werttyp sind sinnvoll. Beispielsweise sehen Sie nie einen Delta-Messwert mit booleschen Daten. Es gibt bestimmte Kombinationen, die zusammen Sinn ergeben.

In der folgenden Tabelle sind die unterstützten Messwerttypen und Werttypen aufgeführt:

Werttyp ANZEIGE DELTA CUMULATIVE4
BOOL yes Nein no
INT64 yes Ja1 yes
DOUBLE yes Ja1 Ja
STRING Ja1 no no
VERTRIEB Ja2 Ja1, 3 Ja

1 Diese Kombination ist in den benutzerdefinierten Messwerten custom.googleapis.com nicht zulässig.
2 Diese Kombination ist für logbasierte Messwerte nicht zulässig. Weitere Informationen finden Sie unter Logbasierte Verteilungsmesswerte konfigurieren.
3 Dies ist die einzige zulässige Kombination für logbasierte Messwerte logging.googleapis.com/user mit dem Werttyp DISTRIBUTION. Weitere Informationen finden Sie in der Referenz zur Logging API in der Referenz zur Logging API im Abschnitt Feld metricDescriptor.LogMetric
4 Kumulative Messwerte können nicht direkt für Diagramme oder Benachrichtigungen in Monitoring verwendet werden. Sie lassen sich jedoch zu nicht kumulativen Messwerten zusammenfassen und auf diese Weise nutzen. Weitere Informationen finden Sie unter Arten, Typen und Konvertierungen.

Wenn Sie eigene Messwerte erstellen, dürfen Sie außerdem nur gültige Kombinationen aus Werttypen und Messwerttypen verwenden.

Benutzerdefinierte Messwerte mit Stringwerten emulieren

Stringwerte in benutzerdefinierten Messwerten werden nicht unterstützt. Sie können jedoch die Stringwerte-Messwertfunktion so replizieren:

  • Erstellen Sie einen GAUGE-Messwert mit einem INT64-Wert als Enum, das einem Stringwert zugeordnet ist. Beim Abfragen des Messwerts die Aufzählung extern in einen Stringwert übersetzen
  • Erstellen Sie einen GAUGE-Messwert mit einem BOOL-Wert und einem Label, dessen Wert einer der Strings ist, die Sie überwachen möchten. Verwenden Sie den booleschen Wert, um anzugeben, ob der Wert der aktive Wert ist.

Angenommen, Sie möchten einen Stringwert mit dem Namen "Status" mit den möglichen Optionen "OK", "OFFLINE" oder "AUSSTEHEND" erstellen. Sie könnten einen GAUGE-Messwert mit einem Label namens status_value erstellen. Jede Aktualisierung würde drei Zeitreihen schreiben, eine für jede status_value (OK, OFFLINE oder AUSSTEHEND) mit dem Wert 1 für „wahr“ oder 0 für „falsch“.