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 in Diagrammen darstellen.

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 seit der letzten Aufzeichnung misst. Zum Beispiel sind Messwerte, die die Anzahl der Anfragen messen, Delta-Messwerte. Jeder Wert zeichnet auf, wie viele Anfragen seit dem letzten Datenpunkt 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 Kumulativ4
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, 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 Kombination, die für logbasierte Messwerte (logging.googleapis.com/user) mit dem Werttyp DISTRIBUTION zulässig ist. Weitere Informationen finden Sie im Feld metricDescriptor der LogMetric-Referenz zur Logging API.
4 Kumulative Messwerte können nicht direkt für Diagramme oder Benachrichtigungen in Monitoring verwendet werden. Sie können jedoch in nicht kumulative Messwerte zusammengefasst werden, die verwendet werden können. auf diese Art. 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 Stringwert emulieren

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

  • Erstellen Sie einen GAUGE-Messwert mit einem INT64-Wert als Aufzählung, die einem Stringwert zugeordnet ist. Übersetzen Sie die Aufzählung extern in einen Stringwert, wenn Sie den Messwert abfragen.
  • Erstellen Sie einen GAUGE-Messwert mit einem BOOL-Wert und einem Label, dessen Wert einer der zu überwachenden Strings ist. Geben Sie den booleschen Wert an, um anzugeben, ob der Wert der aktive Wert ist.

Angenommen, Sie möchten einen Stringwert-Messwert namens "status" mit den möglichen Optionen "OK", "OFFLINE" oder "AUSSTEHEND" erstellen. Sie können einen GAUGE-Messwert mit einem Label namens status_value erstellen. Bei jeder Aktualisierung werden drei Zeitachsen geschrieben, eine für jede status_value (OK, OFFLINE oder AUSSTEHEND) mit dem Wert 1 für "true" oder 0 für "false".