Tracing in Jitterbit App Builder

Übersicht

Tracing ist eine diagnostische Funktion, die im App Builder verfügbar ist und es Entwicklern ermöglicht, Anwendungen zu debuggen. Tracing kann ein wichtiges Werkzeug zur Fehlersuche bei leistungsbezogenen Problemen in einer App sowie zur allgemeinen Problemlösung sein. Es gibt mehrere Möglichkeiten, die Tracing-Funktion zu aktivieren, und sie ist mit automatischen Deaktivierungsmechanismen ausgestattet.

Tracing sollte vorzugsweise in einer Entwicklungsumgebung verwendet werden, ist jedoch bei Bedarf auch in der Produktion verfügbar. Aus Leistungsgründen sollte das Ausführen von Tracing in der Produktion eingeschränkt werden, es sei denn, es ist unbedingt erforderlich.

Tracing aktivieren

Benutzer, die die Berechtigung zur Nutzung von Tracing haben, können darauf von mehreren verschiedenen Orten im App Builder zugreifen.

Vom Benutzerprofil

Tracing wird auf der Ebene des Benutzerprofils gespeichert. Wenn Sie ein Entwicklerbenutzer sind, sehen Sie eine Tracing-Option auf Ihrer Benutzerprofilseite. Wenn das Tracing-Feld aktiviert ist, wurde die Trace-Funktion für den zugehörigen Benutzer aktiviert oder eingeschaltet.

Von der Sicherheit

Tracing kann auch über Sicherheit > Benutzer aktiviert oder eingeschaltet werden. Ein Entwicklerbenutzer kann zum Sicherheitsbereich des App Builders navigieren, zum Bildschirm Benutzer gehen und einen einzelnen Benutzerdatensatz aus diesem Bereich öffnen, um auf die Tracing-Option zuzugreifen. Wenn das Tracing-Feld aktiviert ist, wurde die Trace-Funktion für den zugehörigen Benutzer aktiviert oder eingeschaltet.

Vom Seiten-Designer

Vorausgesetzt, Sie haben die richtigen Designberechtigungen, können Sie auch in das Tracing für eine Seite vom Bildschirm des Seiten-Designs eintauchen.

Vom Monitor

Tracing kann auch sowohl aktiviert als auch die Ergebnisse vom Monitorbildschirm im App Builder angezeigt und interpretiert werden. Um hierher zu gelangen, navigieren Sie zu Monitor > Leistung. Sobald Sie hier sind, wählen Sie den Benutzer aus, für den die Trace-Informationen ausgeführt werden sollen, und setzen den Status auf Ein. Mit aktivierter Funktion führt der Benutzer dann die Aktivität aus, die Sie nachverfolgen möchten. Zum Beispiel navigieren Sie zu den betreffenden Seite(n).

Das Trace-Tool erfasst die resultierenden Metriken, die als minimale, durchschnittliche und maximale Zeit für jeden Typ von gespeicherter Metrik angezeigt werden. Sie können auf die Metriken klicken und tiefer eintauchen, um zu sehen, welche am langsamsten ist.

• Unter 1 Sekunde ist grün
• 1 bis 2 Sekunden ist gelb
• Über 2 Sekunden ist rot

Ein Blick auf die Panels zeigt beispielsweise, dass die Seite des Business Rule Builders am langsamsten ist, aufgrund der folgenden Panels/Regeln.

Reset trace

Zurücksetzen löscht die Trace-Informationen für das aktuelle Filterpanel, sodass Sie Informationen entfernen können, die Sie nicht interessieren, und dann neue Aktionen durchführen und die Ergebnisse sehen können.

Der Status Ein oder Aus bezieht sich auf den ausgewählten Benutzer, in diesem Fall den Systemadministrator.

Maintenance

Standardmäßig werden alle Trace-Datensätze in der App Builder-Datenbank in der Tabelle Dg_Trace gespeichert. Jede Stunde wird eine geplante Aufgabe ausgeführt, um Datensätze aus dieser Tabelle zu löschen und zu bereinigen. Seit Version 4.53 wird der Trace-Modus nach 60 Minuten automatisch deaktiviert.

Beispielanwendungsfall

Ein Beispielanwendungsfall, bei dem Sie Trace verwenden könnten, um Einblicke in den App Builder zu gewinnen, ist das Nachverfolgen eines Wertes, der geändert wird, wenn Sie eine Spalte zu einer Tabelle hinzufügen.

Wenn wir eine neue Spalte zu einer Tabelle hinzufügen und einfach einen logischen Datentyp von Währung auswählen, sieht der Bildschirm im App Builder so aus:

Schauen wir uns an, was der App Builder im Trace protokolliert hat:

Das erste Ereignis war das Laden der Daten für die Auswahlliste des Logical Datentyps. Sie können tiefer eintauchen und mehr Details erhalten, indem Sie auf den orangefarbenen Pfeil klicken.

Teilt Ihnen mit, dass Aktionen ausgeführt wurden, lassen Sie uns weiter ins Detail gehen.

Das Filter-Plugin wurde ausgeführt, welches das tatsächliche Laden von Daten aus der Datenbank übernimmt.

Jetzt können Sie die SQL-Anweisung sehen, die ausgeführt wurde, um Daten für die Auswahlliste zurückzugeben.

Lassen Sie uns nach oben springen und die Zelländerung sehen, dies ist das, was ausgeführt wird, wenn der Benutzer den Datentyp Currency aus der Auswahlliste auswählt.

Sie können sehen, dass auch Standardwerte und Sichtbarkeiten ausgeführt wurden, und da die Zeile orange ist, zeigt es uns, dass sich der aktuelle Zustand der Zeile geändert hat.

Durch die Auswahl der Zeile "Defaults" wird angezeigt, welche Standardwerte geändert wurden. Da wir "Aktuell" ausgewählt haben, wurden diese Werte standardmäßig übernommen. Lassen Sie uns weiter ins Detail gehen, um zu sehen, welche Standardregeln diese Änderungen verursacht haben.

Sie können sehen, dass 9 Standardzeilen ausgeführt wurden, während 2 von ihnen tatsächlich zu einer Änderung des aktuellen Zeilenstatus führten. Db_Column_Physical_StorageDataTypeDefault änderte die StorageDataTypeId und später änderte Db_DefaultsByLogicalStorageDataType die Präzision und den Maßstab. Lassen Sie uns weiter ins Detail gehen und die SQL-Anweisung sehen, die dies verursacht hat.

Hier können Sie sehen, dass die WHERE-Klausel verwendet wird und dieser Wert tatsächlich frühzeitig standardmäßig übernommen wurde.