Performance-Aufzeichnung

Ziele

• Auffinden von Performance-Problemen
• Einheitliche Aufzeichnung von Zeit- und Ressourcendaten
• Transparenz bezüglich Skalierung und Ressourcennutzung
• Einsetzbarkeit mit geringem Aufwand
• Analysierbarkeit durch PLANTA möglichst ohne Übersendung der Nutzdaten (in Form eines Datenbankabzuges)

Konfiguration und Nutzungshinweise

Konfiguration

• Die Aufzeichnung der Performance-Daten in DT324 Statistik kann wie folgt aktiviert werden:
  • Die Schaltfläche Perfomance-Counting: DEAKTIVIERT im Modul Performance-History-Auswertung betätigen.
  • Die Funktion performance_counting_enable() über die Python API oder alternativ ausführen.
  • In der Konfigurationsdatei globals.conf den Parameter performance_counting = "true" setzen und anschließend den Server neustarten.
• Vorteil der Python-Funktion ist, dass ab dem Moment der Ausführung Performance-Daten von allen laufenden und gestarteten Sitzungen aufgezeichnet werden.
• Für zeitlich aussagekräftige Performance-Aufzeichnungen sollte das Softlimit bzgl. der Datensatzmenge (@G80109) deaktiviert werden (siehe hierzu Limits für Datenbank-Abfragen per globale Variablen bestimmen).

Tipp

• Mit dem nachfolgenden Python-Code kann ein Makro-Modul angelegt werden, das beim ersten Ausführen die Performance-History einschaltet und beim zweiten Ausführen wieder ausschaltet.
  • Nach Aktivieren des Performance-Countings wird PCOUNT: ON ausgegeben und nach Deaktivieren PCOUNT: OFF.

'''Toggles performance counting globally and 
shows a message depending on current setting'''

cur_title = ppms.ui_get_system_title() 
on_str = 'Performance Counting: ON' 
off_str = 'Performance Counting: OFF'  

if ppms.performance_counting_is_enabled():     
    ppms.performance_counting_disable()     
    ppms.ui_message_box(off_str) 
else:     
    ppms.performance_counting_enable()     
    ppms.ui_message_box(on_str)

Details

• Eine Statusmeldung beim Start jeder neuen Sitzung informiert über die Performance-Aufzeichnung.
• Da der PLANTA-Server für jedes Event einen Datensatz schreibt, kann die Messung die Performance des Systems deutlich reduzieren.
  • Der Einsatz ist somit nur für die Fehlersuche bzw. Aufdeckung von Performance-Problemen sinnvoll.
• Werden die Daten nicht mehr benötigt, sollte die Tabelle DT324 Statistik geleert werden, um einer übermäßigen Beanspruchung des der Datenbank zur Verfügung stehenden Datenspeichers entgegenzuwirken.
• Bitte beachten Sie, dass die Performance-History-Auswertung global für das gesamte System aktiviert bzw. deaktiviert wird, nicht nur für eine bestimmte Session.

Ansicht der Daten, Übermittlung an PLANTA

Ansicht/Interpretation

• Die Performance-Daten können über das Modul Performance History-Auswertung angezeigt werden.
• Eine Übersicht der einzelnen Datenfelder finden Sie hier.
• Zu beachten ist, dass durch Messungenauigkeiten/Rundungsfehler auch negative Werte vorkommen können, wie z.B. in dem Feld Unspecified (real).

Export zur Übermittlung

• Für den Export der Daten sollte das Excel-Format genutzt werden:
  • Hierzu das o.g. Modul Performance History-Auswertung öffnen.
  • Mit Strg + Q bzw. dem Menüpunkt Daten → Filtern alle Daten laden.
  • Menüpunkt Extras → Daten senden an → Microsoft Excel auswählen.
  • Bulk-Export auswählen.
  • Den Datenbereich Statistik auswählen.
  • Die Checkbox Excel-Funktion "Teilung" für Fenster 1 aktivieren aktivieren.
  • Den Export über Exportieren starten.
  • Nach Beendigung des Fortschrittsdialoges öffnet sich ein Excel-Fenster, in dem sich die exportierten Daten befinden.
• Das Exportergebnis kann nun gesichert und per E-Mail an PLANTA übermittelt werden.
• Zusätzlich zu den Performance-Aufzeichnungen benötigt PLANTA Informationen über den Einsatzkontext des PLANTA-Server.
  • Hierzu bitte die Checkliste Performance-Probleme ausfüllen und mitliefern.