Auf dieser Seite
APM-Span-Objekt
Die folgenden Objekte stehen in direktem Zusammenhang mit der apmspan-API.
Jede Eigenschaft entspricht einer Spalte in der Tabelle otel_traces der Telemetriedatenquelle.
Eine Liste der Spalten finden Sie unter Unterstützte Telemetriedatenspalten.
APM-Span
Das APM-Span-Objekt stellt einen Span dar (eine einzelne Operation innerhalb eines Trace, z. B. eine HTTP-Anfrage, eine Datenbankabfrage oder ein Funktionsaufruf).
Spans bilden eine Hierarchie, die beim Root-Span beginnt, der die erste Operation der Anfrage darstellt. Jeder andere Span ist ein untergeordneter Span des Spans, während dessen Operation er gestartet wurde.
Das APM-Span-Objekt verfügt über die folgenden Eigenschaften:
| Property | Type | Description |
|---|---|---|
| timestamp | integer | Unix-Zeit (in Nanosekunden), zu der der Span gestartet wurde. Property behavior: - read-only |
| traceid | string | ID des Trace, zu dem der Span gehört. Property behavior: - read-only |
| spanid | string | ID des Spans. Property behavior: - read-only |
| parent_spanid | string | ID des übergeordneten Spans. Beim Root-Span leer. Property behavior: - read-only |
| trace_state | string | Zusätzliche Daten, sofern vorhanden, die Tracing-Tools an den Trace anhängen (siehe W3C Trace Context). Property behavior: - read-only |
| span_name | string | Name der Operation, die der Span darstellt (z. B. mysqli_query).Property behavior: - read-only |
| span_kind | string | Rolle des Spans. Mögliche Werte: Unspecified - Span-Typ 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. das Senden einer Nachricht);Consumer - Verarbeitung einer asynchronen Operation.Property behavior: - read-only |
| service_name | string | Name des Dienstes, der den Span erzeugt hat (z. B. zabbix-frontend), übernommen aus dem OpenTelemetry-Ressourcenattribut service.name.Property behavior: - read-only |
| resource_attributes | object | Schlüssel-Wert-Ressourcenattribute des Spans (z. B. host.name: eabf8c2a5ddc).Property behavior: - read-only |
| scope_name | string | Name des Instrumentierungsbereichs, der den Span erzeugt hat. Property behavior: - read-only |
| scope_version | string | Version des Instrumentierungsbereichs. Property behavior: - read-only |
| span_attributes | object | Schlüssel-Wert-Span-Attribute des Spans (z. B. db.system: mysql).Property behavior: - read-only |
| duration | integer | Dauer des Spans in Nanosekunden. Property behavior: - read-only |
| status_code | string | Status der Operation, die der Span darstellt. Mögliche Werte: Unset - dem Span wurde kein expliziter Status zugewiesen;Ok - die Operation wurde erfolgreich abgeschlossen;Error - die Operation wurde mit einem Fehler abgeschlossen.Property behavior: - read-only |
| status_message | string | Zusätzliche Informationen, sofern vorhanden, zum Status des Spans. Property behavior: - read-only |
| events | array | Array von Ereignis-Objekten des Spans, also bemerkenswerten Zeitpunkten während der Operation (z. B. Ausnahmen). Property behavior: - read-only |
| links | array | Array von Link-Objekten des Spans, die auf verwandte Spans im selben oder in einem anderen Trace verweisen. Property behavior: - read-only |