APM-Trace-Objekt
Die folgenden Objekte stehen in direktem Zusammenhang mit der apmtrace-API.
Jede Eigenschaft mit Ausnahme von span_count und error_count entspricht einer Spalte in der Tabelle otel_traces der Telemetriedatenquelle.
Die meisten Eigenschaften entsprechen der Spalte mit demselben Namen (z. B. entspricht die Eigenschaft span_name der Spalte SpanName).
Wenn die Namen voneinander abweichen, werden die Spalten der Datenquelle in den folgenden Tabellen angegeben.
Eine Liste der Spalten finden Sie unter Unterstützte Spalten für Telemetriedaten.
APM-Trace
Das APM-Trace-Objekt stellt einen Trace dar (den Pfad, den eine Anfrage durch Ihre Anwendungen und Dienste nimmt). Ein Trace besteht aus einem oder mehreren Spans; jeder Span stellt eine einzelne Operation dar.
Das APM-Trace-Objekt basiert auf dem Root-Span des Traces (dem Span, der den Trace startet und keinen übergeordneten Span hat).
Alle Eigenschaften enthalten Daten des Root-Spans, mit Ausnahme von span_count und error_count, die aus allen Spans des Traces berechnet werden.
Das APM-Trace-Objekt hat die folgenden Eigenschaften:
| Property | Type | Description |
|---|---|---|
| timestamp | integer | Unix-Zeit (in Nanosekunden), zu der der Root-Span gestartet wurde. Verhalten der Eigenschaft: - nur lesbar |
| traceid | string | ID des Traces, die von allen Spans dieses Traces gemeinsam verwendet wird. Verhalten der Eigenschaft: - nur lesbar |
| spanid | string | ID des Root-Spans. Verhalten der Eigenschaft: - nur lesbar |
| trace_state | string | Zusätzliche Daten, sofern vorhanden, die Tracing-Tools an den Trace anhängen (siehe W3C Trace Context). Verhalten der Eigenschaft: - nur lesbar |
| span_name | string | Name der Operation, die der Root-Span darstellt (z. B. POST /zabbix.php).Verhalten der Eigenschaft: - nur lesbar |
| span_kind | string | Rolle des Root-Spans. Mögliche Werte: Unspecified – Span-Art ist nicht angegeben;Internal – innerhalb einer Anwendung ausgeführte Operation;Server – Verarbeitung einer eingehenden Anfrage;Client – ausgehende Anfrage;Producer – Erstellung einer asynchronen Operation (z. B. Senden einer Nachricht);Consumer – Verarbeitung einer asynchronen Operation.Verhalten der Eigenschaft: - nur lesbar |
| service_name | string | Name des Dienstes, der den Root-Span erzeugt hat (z. B. zabbix-nginx), übernommen aus dem OpenTelemetry-Ressourcenattribut service.name.Verhalten der Eigenschaft: - nur lesbar |
| resource_attributes | object | Schlüssel-Wert-Ressourcenattribute des Root-Spans (z. B. host.name: eabf8c2a5ddc).Verhalten der Eigenschaft: - nur lesbar |
| scope_name | string | Name des Instrumentierungsbereichs, der den Root-Span erzeugt hat. Verhalten der Eigenschaft: - nur lesbar |
| scope_version | string | Version des Instrumentierungsbereichs. Verhalten der Eigenschaft: - nur lesbar |
| span_attributes | object | Schlüssel-Wert-Span-Attribute des Root-Spans (z. B. http.method: POST).Verhalten der Eigenschaft: - nur lesbar |
| duration | integer | Dauer des Traces in Nanosekunden. Verhalten der Eigenschaft: - nur lesbar |
| status_code | string | Status der Operation, die der Root-Span darstellt. Mögliche Werte: Unset – dem Root-Span wurde kein expliziter Status zugewiesen;Ok – die Operation wurde erfolgreich abgeschlossen;Error – die Operation wurde mit einem Fehler abgeschlossen.Verhalten der Eigenschaft: - nur lesbar |
| status_message | string | Zusätzliche Informationen, sofern vorhanden, zum Status des Root-Spans. Verhalten der Eigenschaft: - nur lesbar |
| events | array | Array von Ereignis-Objekten des Root-Spans, also bemerkenswerten Zeitpunkten während der Operation (z. B. Ausnahmen). Verhalten der Eigenschaft: - nur lesbar |
| links | array | Array von Link-Objekten des Root-Spans, die auf zugehörige Spans im selben oder in einem anderen Trace verweisen. Verhalten der Eigenschaft: - nur lesbar |
| span_count | integer | Gesamtanzahl der Spans im Trace. Verhalten der Eigenschaft: - nur lesbar |
| error_count | integer | Anzahl der Spans im Trace, bei denen status_code auf Error gesetzt ist.Verhalten der Eigenschaft: - nur lesbar |
Ereignis
Das Ereignisobjekt verfügt über die folgenden Eigenschaften.
| Property | Type | Description |
|---|---|---|
| timestamp | integer | Unix-Zeit (in Nanosekunden), zu der das Ereignis aufgetreten ist. Spalte der Datenquelle: Events.Timestamp |
| name | string | Name des Ereignisses. Spalte der Datenquelle: Events.Name |
| attributes | object | Schlüssel-Wert-Attribute mit zusätzlichen Informationen zum Ereignis, sofern vorhanden. Spalte der Datenquelle: Events.Attributes |
Link
Das Link-Objekt verfügt über die folgenden Eigenschaften.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| traceid | string | ID des Traces, der den verknüpften Span enthält. Datenqualtenspalte: Links.TraceId |
| spanid | string | ID des verknüpften Spans. Zusammen mit traceid identifiziert diese ID den verknüpften Span eindeutig.Datenqualtenspalte: Links.SpanId |
| trace_state | string | Trace-Status des verknüpften Spans, sofern vorhanden (siehe W3C Trace Context). Datenqualtenspalte: Links.TraceState |
| attributes | object | Schlüssel-Wert-Attribute mit zusätzlichen Informationen zum Link. Datenqualtenspalte: Links.Attributes |