Tracer-Einstellungen verwalten
Tracer-Einstellungen
Der Tracer protokolliert und zeigt Ereignisse an, die bei der Arbeit mit der Pega-Plattform auftreten können. Der Einsatz des Tracers ist ressourcenintensiv und verlangsamt die Anwendungs-Performance erheblich. Um die Auswirkungen bei der Arbeit mit dem Tracer zu verringern, öffnen und konfigurieren Sie die Tracer-Einstellungen so, dass nur die erforderlichen Informationen erfasst werden. Unterbrechen Sie die Protokollierung, bis Sie den Teil der Anwendung ausführen, in dem Sie Fehler beheben möchten.
Die Tracer-Symbolleiste befindet sich oben rechts über der Protokollanzeige. Die Symbolleiste besteht aus Schaltflächen, mit denen Sie die erfassten Ereignisse verwalten können.
Tipp: Sie können nur mit einem Tracer pro Operator und pro Node arbeiten.
Klicken Sie im nachstehenden Bild auf die Pluszeichen (+), wenn Sie mehr über die Schaltflächen Pause, Clear und Save in der Tracer-Symbolleiste erfahren möchten.
Ereignis-Protokollierung optimieren
Bevor Sie mit der Erfassung von Ereignissen beginnen, grenzen Sie die zu erfassenden Ergebnisse ein. Geben Sie die zu protokollierenden Ereignistypen und Abbruchbedingungen mithilfe der Schaltflächen Settings, Breakpoints, Watch und Remote Tracer in der Tracer-Symbolleiste an.
Klicken Sie im folgenden Bild auf die Pluszeichen (+), um mehr über die Schaltflächen Settings, Breakpoints, Watch und Remote Tracer in der Tracer-Symbolleiste zu erfahren:
Konfiguration der Einstellungen
Mit Settings zeigen Sie die Konfigurationsoptionen für Ihren „Trace“ an, um Ereignistypen und Regeln aufzunehmen und die Anzahl der auszugebenden Datenzeilen zu definieren.
Mit den Einstellungsoptionen können Sie die Menge der erfassten Informationen begrenzen. Sie können die Anzeigeergebnisse des Tracers nach Ereignis, Ereignistyp, RuleSet und Anhaltebedingungen filtern. Das ist z. B. dann praktisch, wenn Sie lokale Variablen bei der Nachverfolgung ausschließen möchten oder wenn Sie sehen wollen, welche Aktivitäten ohne die zugehörigen Schritte durchgeführt werden. Durch die Auswahl von Anhaltebedingungen wird der Tracer angehalten, wenn das System einen Fehler erzeugt.
Die folgenden beiden Abbildungen zeigen einen Vergleich der Anzahl der Ereignisse, die vor und nach dem Entfernen von Activity-Schritten aus der Liste der Tracing-Ereignisse entfernt wurden. In der linken Abbildung umfasst der Trace Schritte für alle während des Trace ausgeführten Aktivitäten. Die Schritte für die Activity Finish Assignment befinden sich in den Zeilen 25–32.
Die rechte Abbildung zeigt die nachverfolgten Ergebnisse für dieselbe Activity, wenn Activity-Schritte aus den Tracing-Ereignissen entfernt wurden. Die Activity Finish Assignment bekommt eine eigene Zeile für die Activity. Sie befindet sich in Zeile 7.
Verschieben Sie in der Mitte des folgenden Bildes die vertikale Linie und vergleichen Sie die Tracer-Protokolle.
Optionen bei der Auswahl
Die folgenden zwei Abbildungen zeigen die Auswahloptionen für
, , , undTipp: Um die restlichen Optionen anzusehen und auszuwählen, scrollen Sie durch den Abschnitt .
Mit dem Feld Max Trace Events to Display können Sie die Höchstzahl an Ereignissen konfigurieren, die angezeigt werden sollen. Das Maximum der auf dem Bildschirm angezeigten Ereignisse ist wichtig, wenn eine Tracer-Datei aus mehr als 5.000 Zeilen besteht. Gibt ein nachverfolgtes Ereignis 5.001 Datenzeilen aus, wird Zeile 1 in der Anzeige gekürzt. Geben Sie im Feld Max Trace Events to Display 0 (Null) ein, um die Ereignisse herunterzuladen, ohne die Ereignisse auf dem Bildschirm anzuzeigen.
Hinweis: Jede Erhöhung der Anzahl der anzuzeigenden Ereignisse geht zu Lasten des Arbeitsspeichers und kann sich auf die Systemleistung auswirken.
Funktionen „Breakpoints“ und „Watch“
Sie können einen oder mehrere Breakpoints für eine oder mehrere zu verfolgende Activities konfigurieren. Wenn die Activity beginnt, unterstreicht das Tracer-Fenster das Ereignis und das Tracing wird unterbrochen. Das Tracing wird fortgesetzt, wenn Sie auf Play klicken oder wenn eine Stunde vergeht (je nachdem, was zuerst eintritt). Sie können so den Fortschritt der konfigurierten Aktivität überwachen.
Hinweis: Wird der Tracer aufgrund eines Breakpoints angehalten, wird auch Ihr Thread nicht weiter verarbeitet. Mit Play wird die Verarbeitung fortgesetzt.
Im folgenden Beispiel wird für die Activity SendSimpleEmail in der Klasse Work ein „Breakpoint“ konfiguriert. Der Beginn des Ereignisschrittes wird in der Anzeige hervorgehoben.
Vorsicht: Breakpoints werden für Tracing-Service-Regeln und Anwendungen mit React-basierter UI nicht unterstützt.
Die Funktion Watch ist mit der Breakpoint-Funktion für Haltepunkte vergleichbar, dient aber zum Überwachen bestimmter Eigenschaftswerte oder Werte, um festzustellen, ob und wann sich die Eigenschaftswerte ändern. Diese Option ist nützlich, um beim Tracing Eigenschaftswerte, Berechnungskonsistenz und Muster zu prüfen.
Vorsicht: Watch wird für Tracing-Service-Regeln und Anwendungen mit React-basierter UI nicht unterstützt.
Hinweis: Der Tracer hebt den Eigenschaftswechsel in Gelb hervor. Zudem gibt es ein Property Inspector-Tool, das anzeigt, wie sich die Werte verändert haben.
In der folgenden Abbildung wird für die Eigenschaft .BiweeklySalary auf der pyWorkPage eine Überwachung konfiguriert. Sie können weitere zu beobachtende Variablen ergänzen oder ausgewählte Variablen entfernen. Mit Close werden die konfigurierten Variablen gespeichert.
Die folgende Abbildung zeigt den Property Inspector. Sie sehen dort, dass sich der Eigenschaftswert von „0“ auf „2083.33“ geändert hat.
Die Felder OldValue und CurrentValue im Property Inspector werden automatisch aktualisiert, wenn sich der Eigenschaftswert ändert.
Prüfen Sie mit der folgenden Interaktion Ihr Wissen:
Dieses Thema ist im folgenden Modul verfügbar:
Wenn Probleme mit den Lerninhalten auftreten, lesen Sie bitte die Pega Academy Support FAQs.
Möchten Sie uns dabei helfen, diesen Inhalt zu verbessern?