Auf dieser Seite
APM-Metrikobjekt
Die folgenden Objekte stehen in direktem Zusammenhang mit der apmmetric-API.
Jede Eigenschaft mit Ausnahme von type entspricht einer Spalte in den Metriktabellen (otel_metrics_gauge, otel_metrics_sum, otel_metrics_histogram und otel_metrics_exponential_histogram) der Telemetriedatenquelle.
Die meisten Eigenschaften entsprechen der Spalte mit demselben Namen (z. B. entspricht die Eigenschaft metric_name der Spalte MetricName).
Wenn sich die Namen unterscheiden, werden die Spalten der Datenquelle in den folgenden Tabellen angegeben.
Eine Liste der Spalten finden Sie unter Unterstützte Telemetriedatenspalten.
APM-Metrik
Das APM-Metrikobjekt stellt einen Datenpunkt einer Metrik dar (den Wert oder aggregierte Werte einer Messung zu einem bestimmten Zeitpunkt).
Das APM-Metrikobjekt verfügt über die folgenden Eigenschaften:
| Property | Type | Description |
|---|---|---|
| type | integer | Typ des Datenpunkts. Mögliche Werte: 0 - Gauge; 1 - Summe; 2 - Histogramm; 3 - Exponentielles Histogramm. Der Typ wird durch die Tabelle bestimmt, in der der Datenpunkt gespeichert ist: otel_metrics_gauge, otel_metrics_sum, otel_metrics_histogram oder otel_metrics_exponential_histogram.Verhalten der Eigenschaft: - read-only |
| resource_attributes | object | Schlüssel-Wert-Ressourcenattribute des Datenpunkts (z. B. host.name: eabf8c2a5ddc).Verhalten der Eigenschaft: - read-only |
| resource_schema_url | string | URL, sofern vorhanden, des OpenTelemetry-Schemas der Ressourcenattribute. Verhalten der Eigenschaft: - read-only |
| scope_name | string | Name des Instrumentierungsbereichs, der den Datenpunkt erzeugt hat. Verhalten der Eigenschaft: - read-only |
| scope_version | string | Version des Instrumentierungsbereichs, sofern vorhanden. Verhalten der Eigenschaft: - read-only |
| scope_attributes | object | Schlüssel-Wert-Attribute des Instrumentierungsbereichs. Verhalten der Eigenschaft: - read-only |
| scope_schema_url | string | URL, sofern vorhanden, des OpenTelemetry-Schemas des Instrumentierungsbereichs und seiner Attribute. Verhalten der Eigenschaft: - read-only |
| service_name | string | Name des Dienstes, der den Datenpunkt erzeugt hat (z. B. zabbix-frontend), übernommen aus dem OpenTelemetry-Ressourcenattribut service.name.Verhalten der Eigenschaft: - read-only |
| metric_name | string | Name der Metrik, zu der der Datenpunkt gehört (z. B. http.server.request.duration).Verhalten der Eigenschaft: - read-only |
| metric_description | string | Beschreibung der Metrik, sofern vorhanden. Verhalten der Eigenschaft: - read-only |
| metric_unit | string | Einheit der Metrikwerte, sofern vorhanden (z. B. s oder By; siehe UCUM).Verhalten der Eigenschaft: - read-only |
| attributes | object | Schlüssel-Wert-Attribute des Datenpunkts (z. B. http.request.method: POST).Verhalten der Eigenschaft: - read-only |
| start_time_unix | integer | Unix-Zeit (in Nanosekunden), zu der der Messzeitraum des Datenpunkts begonnen hat. Verhalten der Eigenschaft: - read-only |
| time_unix | integer | Unix-Zeit (in Nanosekunden) des Datenpunkts. Bei Datenpunkten vom Typ Summe, Histogramm und Exponentielles Histogramm ist dies das Ende des Messzeitraums. Verhalten der Eigenschaft: - read-only |
| value | float | Wert des Datenpunkts. Gilt für Datenpunkte vom Typ Gauge und Summe. Standardwert: 0.Verhalten der Eigenschaft: - read-only |
| flags | integer | Bitmaske der Datenpunkt-Flags. Wenn das niederwertigste Bit gesetzt ist (Wert 1), wurde für den Datenpunkt kein Wert aufgezeichnet.Verhalten der Eigenschaft: - read-only |
| exemplars | array | Array von Exemplar-Objekten, also einzelnen Messungen, die als Beispiele zusammen mit dem Trace und Span, während derer sie aufgezeichnet wurden, gespeichert werden. Verhalten der Eigenschaft: - read-only |
| aggregation_temporality | integer | Gibt an, wie die Werte des Datenpunkts über die Zeit aggregiert werden. Gilt für Datenpunkte vom Typ Summe, Histogramm und Exponentielles Histogramm. Mögliche Werte: 0 - (Standardwert) Nicht angegeben; 1 - Delta (aggregiert über den Zeitraum seit dem vorherigen Datenpunkt); 2 - Kumulativ (aggregiert über den Zeitraum seit start_time_unix).Verhalten der Eigenschaft: - read-only |
| is_monotonic | boolean | Gibt an, ob die Summe im Laufe der Zeit nur steigen oder gleich bleiben kann. Gilt für Datenpunkte vom Typ Summe. Standardwert: false.Verhalten der Eigenschaft: - read-only |
| count | integer | Anzahl der Messungen im Datenpunkt. Gilt für Datenpunkte vom Typ Histogramm und Exponentielles Histogramm. Standardwert: 0.Verhalten der Eigenschaft: - read-only |
| sum | float | Summe aller Messungen im Datenpunkt. Gilt für Datenpunkte vom Typ Histogramm und Exponentielles Histogramm. Standardwert: 0.Verhalten der Eigenschaft: - read-only |
| bucket_counts | array | Array von Ganzzahlen mit der Anzahl der Messungen in jedem Histogramm-Bucket. Die Buckets werden durch explicit_bounds definiert.Gilt für Datenpunkte vom Typ Histogramm. Standardwert: [].Verhalten der Eigenschaft: - read-only |
| explicit_bounds | array | Array von Gleitkommazahlen mit den Grenzen zwischen Histogramm-Buckets. Gilt für Datenpunkte vom Typ Histogramm. Standardwert: [].Verhalten der Eigenschaft: - read-only |
| min | float | Kleinster Messwert im Datenpunkt. Gilt für Datenpunkte vom Typ Histogramm und Exponentielles Histogramm. Standardwert: 0.Verhalten der Eigenschaft: - read-only |
| max | float | Größter Messwert im Datenpunkt. Gilt für Datenpunkte vom Typ Histogramm und Exponentielles Histogramm. Standardwert: 0.Verhalten der Eigenschaft: - read-only |
| scale | integer | Skalierung des exponentiellen Histogramms, die die Bucket-Grenzen und die Auflösung bestimmt. Eine höhere Skalierung ergibt schmalere Buckets und eine feinere Auflösung; eine niedrigere Skalierung ergibt breitere Buckets und eine gröbere Auflösung. Gilt für Datenpunkte vom Typ Exponentielles Histogramm. Standardwert: 0.Verhalten der Eigenschaft: - read-only |
| zero_count | integer | Anzahl der Messungen im Null-Bucket des exponentiellen Histogramms. Gilt für Datenpunkte vom Typ Exponentielles Histogramm. Standardwert: 0.Verhalten der Eigenschaft: - read-only |
| positive_bucket_counts | array | Array von Ganzzahlen mit der Anzahl der positiven Messungen in jedem Bucket des exponentiellen Histogramms. Die Bucket-Grenzen werden durch scale bestimmt; der Index des ersten Buckets wird in positive_offset festgelegt.Gilt für Datenpunkte vom Typ Exponentielles Histogramm. Standardwert: [].Verhalten der Eigenschaft: - read-only |
| positive_offset | integer | Index des ersten Buckets in positive_bucket_counts.Gilt für Datenpunkte vom Typ Exponentielles Histogramm. Standardwert: 0.Verhalten der Eigenschaft: - read-only |
| negative_bucket_counts | array | Array von Ganzzahlen mit der Anzahl der negativen Messungen in jedem Bucket des exponentiellen Histogramms. Die Bucket-Grenzen werden durch scale bestimmt; der Index des ersten Buckets wird in negative_offset festgelegt.Gilt für Datenpunkte vom Typ Exponentielles Histogramm. Standardwert: [].Verhalten der Eigenschaft: - read-only |
| negative_offset | integer | Index des ersten Buckets in negative_bucket_counts.Gilt für Datenpunkte vom Typ Exponentielles Histogramm. Standardwert: 0.Verhalten der Eigenschaft: - read-only |
Exemplar
Das Exemplar-Objekt verfügt über die folgenden Eigenschaften:
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| traceid | string | ID, sofern vorhanden, der Trace, während dessen die Messung aufgezeichnet wurde. Datenspalte: Exemplars.TraceId. |
| spanid | string | ID, sofern vorhanden, des Spans, während dessen die Messung aufgezeichnet wurde. Datenspalte: Exemplars.SpanId. |
| value | float | Wert der Messung. Datenspalte: Exemplars.Value. |
| time_unix | integer | Unix-Zeit (in Nanosekunden), zu der die Messung aufgezeichnet wurde. Datenspalte: Exemplars.TimeUnix. |
| filtered_attributes | object | Schlüssel-Wert-Attribute der Messung, die nicht in den attributes des Datenpunkts enthalten sind.Datenspalte: Exemplars.FilteredAttributes. |