Protokolle
Übersicht
Der Abschnitt APM > Logs zeigt die aus Ihren Anwendungen und Diensten erfassten Protokolleinträge an.
Ein Protokolleintrag ist ein Texteintrag zu einem Ereignis (z. B. einer fehlgeschlagenen Zahlung oder einer Zeitüberschreitung bei einer Datenbank). Jeder Protokolleintrag verfügt über einen Schweregrad und eine Nachricht (Text). Wenn ein Protokolleintrag während eines Vorgangs erzeugt wurde, der Teil eines Trace ist, enthält er außerdem die IDs dieses Traces und Spans.
Jeder Protokolleintrag 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 den Eintrag erstellt hat (z. B. einer Protokollierungsbibliothek).
Um Kontext zu jedem Ereignis bereitzustellen, enthalten Protokolleinträge außerdem Attribute in Form von Schlüssel-Wert-Paaren: Protokollattribute beschreiben das Ereignis selbst (z. B. log.file.path: /var/log/zabbix/zabbix_frontend.log), während Ressourcenattribute den Dienst und die Umgebung beschreiben, in der er ausgeführt wird (z. B. host.name: eabf8c2a5ddc).
Weitere Informationen zu Protokollen finden Sie in der OpenTelemetry-Dokumentation.
Der Abschnitt APM > Logs 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 Protokolleinträge angezeigt werden sollen.
- Filter – zeigt nur die für Sie relevanten Protokolleinträge an.
- Protokollliste – zeigt die Protokolleinträge an.
- Protokolldetails – zeigt die Details des ausgewählten Protokolleintrags an.
Protokollliste
Jede Zeile in der Protokollliste stellt einen Protokolldatensatz dar.
Protokolldatensätze 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. Doppelklicken Sie auf den Rand, um die Größe zurückzusetzen.
Alle Anpassungen werden sofort angewendet und für den aktuellen Benutzer gespeichert.
Die Protokollliste kann folgende Spalten enthalten:
Jede Spalte entspricht einer Spalte in der Tabelle otel_logs 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 Schweregradtext der Spalte SeverityText).
Wenn sich die Namen unterscheiden, wird die Spalte der Datenquelle in der folgenden Tabelle angegeben.
| Spalte | Beschreibung |
|---|---|
| Zeitstempel | Datum und Uhrzeit, zu denen das Ereignis aufgetreten ist. |
| Textkörper | Nachricht des Protokolldatensatzes. |
| Schweregradtext | Von der Anwendung bereitgestellte Schweregradstufe (z. B. INFO, WARN oder ERROR).Die Farbe der Bezeichnung hängt vom Schweregrad ab. |
| Schweregradnummer | Schweregradstufe als Zahl: 0 - UNSPECIFIED. 1-4 - TRACE. 5-8 - DEBUG. 9-12 - INFO. 13-16 - WARN. 17-20 - ERROR. 21-24 - FATAL. |
| Trace-ID | ID des Trace, während dessen der Protokolldatensatz erzeugt wurde, sofern vorhanden. |
| Span-ID | ID des Spans, während dessen der Protokolldatensatz erzeugt wurde, sofern vorhanden. |
| Flags | Trace-Flags des Protokolldatensatzes: 0 - Der Trace wird nicht erfasst. 1 - Der Trace wird erfasst (aufgezeichnet). Spalte der Datenquelle: TraceFlags. |
| Servicename | Service, der den Protokolldatensatz erzeugt hat. |
| Scope-Name | Instrumentierungs-Scope, der den Protokolldatensatz erzeugt hat. |
| Scope-Version | Version des Instrumentierungs-Scopes. |
| Ereignisname | Name des Ereignistyps, den der Protokolldatensatz darstellt, sofern vorhanden. |
| Protokollattribute | Protokollattribute des Protokolldatensatzes. Klicken Sie auf die Drei-Punkte-Schaltfläche  , um alle Attribute anzuzeigen. |
| Ressourcenattribute | Ressourcenattribute des Protokolldatensatzes. Klicken Sie auf die Drei-Punkte-Schaltfläche , um alle Attribute anzuzeigen. |
| Scope-Attribute | Attribute des Instrumentierungs-Scopes. Klicken Sie auf die Drei-Punkte-Schaltfläche , um alle Attribute anzuzeigen. |
Protokolldetails
Klicken Sie in der Protokollliste auf einen Protokolldatensatz, um das Fenster Protokolldetails zu öffnen, in dem alle Informationen zum Protokolldatensatz angezeigt werden.
Das Fenster Protokolldetails kann die folgenden Abschnitte enthalten:
| Abschnitt | Beschreibung |
|---|---|
| Grundlegende Informationen | Trace-ID, Span-ID und Trace-Flags des Protokolldatensatzes. |
| Protokollattribute | Protokollattribute des Protokolldatensatzes. |
| Ressourcenattribute | Schema-URL und Ressourcenattribute. |
| Bereichsattribute | Schema-URL, Name, Version und Attribute des Instrumentierungsbereichs. |
Filter verwenden
Sie können den Filter verwenden, um nur die Protokolldatensätze anzuzeigen, die Sie interessieren.
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 verknüpft.
- Oder - mindestens eine Bedingung muss erfüllt sein.