Traces
Übersicht
Der Abschnitt APM > Traces zeigt die aus Ihren Anwendungen und Diensten erfassten Traces an.
Ein Trace stellt den Pfad dar, den eine Anfrage durch Ihre Anwendungen und Dienste nimmt. Wenn ein Benutzer beispielsweise in einem Onlineshop auf die Schaltfläche Bestellung aufgeben klickt, kann die Anfrage vom Frontend-Dienst über die Checkout- und Zahlungsdienste bis zur Datenbank weitergeleitet werden.
Ein Trace besteht aus Spans. Jeder Span stellt eine einzelne Operation dar, z. B. eine HTTP-Anfrage, die der Frontend-Dienst an den Checkout-Dienst sendet, eine Datenbankabfrage zum Speichern der Bestellung oder einen Funktionsaufruf zur Berechnung der Versandkosten.
Spans bilden eine Hierarchie. Der Root-Span stellt die erste Operation der Anfrage dar. Jeder andere Span ist ein untergeordneter Span des Spans, während dessen Operation er gestartet wurde. Beispielsweise ist der Span, der den Empfang der Anfrage Bestellung aufgeben durch den Frontend-Dienst darstellt, der Root-Span. Der Span, der die Verarbeitung der Bestellung durch den Checkout-Dienst darstellt, ist sein untergeordneter Span.
Jeder Span wird von einem Dienst erzeugt (z. B. zabbix-frontend; benannt durch das OpenTelemetry-Ressourcenattribut service.name) sowie von einem Instrumentierungsbereich, also dem Teil des Codes, der ihn erstellt hat (z. B. eine Bibliothek, die HTTP-Anfragen verfolgt).
Um Kontext zu jeder Operation bereitzustellen, verfügen Spans außerdem über Attribute in Form von Schlüssel-Wert-Paaren: Span-Attribute beschreiben die Operation selbst (z. B. http.method: POST), während Ressourcenattribute den Dienst und die Umgebung beschreiben, in der er ausgeführt wird (z. B. host.name: eabf8c2a5ddc).
Weitere Informationen zu Traces finden Sie in der OpenTelemetry-Dokumentation.
Der Abschnitt APM > Traces enthält die folgenden Elemente:
- Schaltfläche Kioskmodus – zeigt nur den Seiteninhalt ohne Menü und Kopfzeile an.
- Zeitraumauswahl – wählt den Zeitraum aus, für den Traces angezeigt werden sollen.
- Filter – zeigt nur die Traces an, die Sie interessieren.
- Trace-Liste – zeigt die Traces an, die durch ihre Root-Spans beschrieben werden.
- Trace-Panel – zeigt alle Spans des ausgewählten Traces auf einer Zeitleiste an.
Trace-Liste
Jede Zeile in der Trace-Liste stellt einen Trace dar; die Spalten zeigen die Daten seines Root-Spans.
Traces werden in einer anpassbaren Tabelle angezeigt.
Mit der Schaltfläche 
Tabelle anpassen in der Tabellenkopfzeile können Sie Spalten ein- und ausblenden, ihre Reihenfolge ändern und das Layout auf die Standardeinstellungen zurücksetzen.
Sie können außerdem die Größe jeder Spalte ändern, indem Sie ihren rechten Rand ziehen; durch Doppelklicken auf den Rand wird die ursprüngliche Größe wiederhergestellt.
Alle Anpassungen werden sofort angewendet und für den aktuellen Benutzer gespeichert.
Die Trace-Liste kann die folgenden Spalten enthalten:
Jede Spalte entspricht einer Spalte in der Tabelle otel_traces der Telemetriedatenquelle; eine Liste der Spalten finden Sie unter Unterstützte Telemetriedatenspalten.
Die meisten Spalten haben denselben Namen wie in der Datenquelle (z. B. entspricht Trace-ID der Spalte TraceId).
Wenn sich die Namen unterscheiden, wird die Spalte der Datenquelle in der folgenden Tabelle angegeben.
| Spalte | Beschreibung |
|---|---|
| Trace-ID | ID des Traces, die von allen zu diesem Trace gehörenden Spans gemeinsam verwendet wird. |
| Span-ID | ID des Root-Spans. |
| Trace-Status | Zusätzliche Daten, sofern vorhanden, die Tracing-Tools an den Trace anhängen (siehe W3C Trace Context). |
| Servicename | Service, der den Root-Span erzeugt hat, gefolgt von der Anzahl der Spans im Trace. Wenn ein Span den Statuscode Error aufweist (siehe unten), zeigt ein rotes Symbol deren Anzahl an. |
| Operationsname | Operation, die der Root-Span darstellt (z. B. POST /zabbix.php).Spalte der Datenquelle: SpanName. |
| Span-Art | Rolle des Root-Spans: Unspecified – 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. |
| Scope-Name | Instrumentierungs-Scope, der den Root-Span erzeugt hat. |
| Scope-Version | Version des Instrumentierungs-Scopes. |
| Statuscode | Status der Operation, die der Root-Span darstellt: Unset – dem Root-Span wurde kein expliziter Status zugewiesen. Ok – die Operation wurde erfolgreich abgeschlossen. Error – die Operation wurde mit einem Fehler abgeschlossen. |
| Statusmeldung | Zusätzliche Informationen, sofern vorhanden, zum Status. |
| Startzeit | Datum und Uhrzeit, zu denen der Root-Span gestartet wurde. Spalte der Datenquelle: Timestamp. |
| Span-Attribute | Span-Attribute des Root-Spans. Klicken Sie auf die Schaltfläche mit den drei Punkten  , um alle Attribute anzuzeigen. |
| Ressourcenattribute | Ressourcenattribute des Root-Spans. Klicken Sie auf die Schaltfläche mit den drei Punkten , um alle Attribute anzuzeigen. |
| Dauer | Dauer des Traces; der graue Balken zeigt sie relativ zu den anderen Traces an. |
Trace-Bereich
Klicken Sie in der Trace-Liste auf einen Trace, um den Trace-Bereich zu öffnen. Dieser zeigt alle Spans des Traces auf einer Zeitleiste: welche Vorgänge ausgeführt wurden, in welcher Reihenfolge sie ausgeführt wurden und wie lange jeder Vorgang gedauert hat.
Der Trace-Bereich kann folgende Elemente enthalten:
| Element | Beschreibung |
|---|---|
| Trace ID | ID des ausgewählten Traces. |
| Übersicht der Trace-Zeitleiste | Der gesamte Trace mit Spans in bis zu 8 Zeilen (mehrere Spans können sich eine Zeile teilen). Ziehen Sie die Ränder des ausgewählten Bereichs oder den Bereich selbst, um die Span-Zeitleiste auf diesen Teil des Traces zu vergrößern. |
| Span-Baum | Spans in ihrer Hierarchie; jeder Span zeigt seinen Service (fett), den Namen des Vorgangs und die Anzahl der direkten untergeordneten Spans. |
| Span-Zeitleiste | Spans als Balken: Position und Länge zeigen, wann jeder Span gestartet wurde und wie lange er gedauert hat. Marker zeigen Ereignisse (z. B. Ausnahmen) an. Bewegen Sie den Mauszeiger über einen Marker oder klicken Sie darauf, um Details anzuzeigen. |
| Span-Details | Klicken Sie im Span-Baum auf einen Span, um dessen Details und Attribute anzuzeigen. |
Filter verwenden
Sie können den Filter verwenden, um nur die für Sie relevanten Traces anzuzeigen.
Um nach Attributen zu filtern, geben Sie den Attributschlüssel ein, wählen Sie den Operator aus und geben Sie den Attributwert ein.
Die folgenden Operatoren werden unterstützt:
- Enthält - (Standard) der Attributwert enthält die eingegebene Zeichenfolge.
- Ist gleich - der Attributwert entspricht der eingegebenen Zeichenfolge.
- Enthält nicht - der Attributwert enthält die eingegebene Zeichenfolge nicht.
- Ist nicht gleich - der Attributwert entspricht nicht der eingegebenen Zeichenfolge.
- Existiert - das Attribut mit dem eingegebenen Schlüssel existiert.
- Existiert nicht - das Attribut mit dem eingegebenen Schlüssel existiert nicht.
Wenn Sie mehrere Bedingungen hinzufügen, wählen Sie aus, wie diese ausgewertet werden sollen:
- Und/Oder - (Standard) alle Bedingungen müssen erfüllt sein; Bedingungen mit demselben Attributschlüssel werden mit Oder kombiniert.
- Oder - mindestens eine Bedingung muss erfüllt sein.