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 zu Verteilungen finden Sie auf der Referenzseite Distribution. Informationen zum Darstellen dieser Messwerte in einem Diagramm finden Sie unter Verteilungsmesswerte.

Messwertart

Jede Zeitachse enthält den Messwerttyp (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 Delta -Messwert, in dem der Wert die Änderung in einem bestimmten Zeitraum misst. Bei Lesevorgängen ist das Zeitintervall halboffen. Es schließt die Startzeit aus, aber die Endzeit ein: (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.

  • 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 Ja Nein no
INT64 Ja Ja1 Ja
DOUBLE Ja Ja1 Ja
STRING Ja1 no no
VERTRIEB Ja2 Ja1, 3 Ja

1 Diese Kombination ist in benutzerdefinierten Messwerten nicht zulässig. custom.googleapis.com
2 Diese Kombination ist für logbasierte Messwerte nicht zulässig. Weitere Informationen finden Sie unter Logbasierte Messwerte vom Typ „Verteilung“ konfigurieren.
3: 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.
4 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. Wandeln Sie die Enumeration extern in einen Stringwert um, wenn Sie den Messwert abfragen.
  • Erstellen Sie einen GAUGE-Messwert mit einem BOOL-Wert und einem Label, dessen Wert einer der Strings ist, die Sie überwachen möchten. Mit dem booleschen Wert wird angegeben, ob der Wert der aktive Wert ist.

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 jedes status_value (OK, OFFLINE oder AUSSTEHEND), mit dem Wert „1“ für „wahr“ oder „0“ für „falsch“.