Werttypen und Messwertarten

In der Beschreibung des Messwertmodells enthält der Abschnitt Messwerttypen eine allgemeine Beschreibung der Attribute, 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 Informationen zu Verteilungen finden Sie in der Referenz zu Distribution Seite. Informationen zur grafischen Darstellung dieser Messwerte finden Sie unter Verteilungsmesswerte:

Messwertart

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

• Ein Messgerät -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 Deltamesswert, bei dem der Wert die Änderung in einem Zeitintervall misst. Bei Lesevorgängen ist das Zeitintervall halb offen, die Startzeit wird ausgeschlossen, aber Enthält folgende Endzeit: (startTime, endTime]. Zum Beispiel sind Messwerte, die die Anzahl der Anfragen messen, Delta-Messwerte. Jeder Wert zeichnet auf, wie viele Anfragen nach der Startzeit bis einschließlich der Endzeit empfangen wurden.

  Hinweis: Alle Messwerte, bei denen einzelne Elemente über einen bestimmten Zeitraum gezählt werden, sind Delta-Messwerte. Es ist normal, dass solche Werte Ganzzahlen sind, aber für historische Implementierungsgründen werden sie als Gleitkommazahlen angegeben.

• 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	CUMULATIVE^4
BOOL	Ja	Nein	no
INT64	Ja	Ja^1	Ja
DOUBLE	Ja	Ja^1	Ja
STRING	Ja^1	no	no
VERTRIEB	Ja^2	Ja^1, 3	Ja

¹ Diese Kombination ist in benutzerdefinierten Messwerten nicht zulässig, custom.googleapis.com.
² Diese Kombination ist für logbasierte Messwerte nicht zulässig. Weitere Informationen finden Sie unter Logbasierte Verteilungsmesswerte konfigurieren
³: Dies ist die einzige zulässige Kombination für protokollbasierte Messwerte (logging.googleapis.com/user) mit dem Werttyp DISTRIBUTION. Weitere Informationen finden Sie im Feld metricDescriptor in der LogMetric-Referenz der Logging API.
⁴ Kumulative Messwerte können in Monitoring nicht direkt für Diagramme oder Benachrichtigungen verwendet werden. Sie können jedoch zu nicht kumulativen Messwerten zusammengefasst werden, die auf diese Weise verwendet werden können. Weitere Informationen finden Sie unter Arten, Typen und Conversions.

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, der einem Stringwert zugeordnet wird. Übersetzen Sie die Aufzählung extern in einen Stringwert, wenn Sie die Messwert.
• Erstellen Sie einen GAUGE-Messwert mit einem BOOL-Wert und einem Label, dessen Wert einer der folgenden ist: die Sie überwachen möchten. Verwenden Sie den booleschen Wert, um anzugeben, ob der Wert der aktiver Wert.

Angenommen, Sie möchten einen Messwert mit Stringwert namens „status“ mit den möglichen Optionen „OK“, „OFFLINE“ oder „AUSSTEHEND“ erstellen. Sie könnten einen GAUGE-Messwert mit dem Label status_value erstellen. Bei jeder Aktualisierung werden drei Zeitreihen geschrieben, eine für jede status_value (OK, OFFLINE oder AUSSTEHEND), mit dem Wert „1“ für „wahr“ oder „0“ für „falsch“.