SQL Profiling 2.0.3: Konfiguration und Installation
Hinweis:
Sie können das SQL Profiling-Plugin auf der SoftProject-Website unter Ressourcen > Ressourcen > Software X4 BPMS bei unserem Support-Team anfragen. Gehen Sie zu X4 BPMS 7.4.1, und wählen Sie auf der Registerkarte X4 Plugins die Schaltfläche Anfragen neben der Plugin-Beschreibung aus.
Das SQL Profiling-Plugin wird verwendet, um Profiling-Daten in eine relationale SQL-Datenbank zu speichern. Dazu müssen Sie das SQL Profiling-Plugin mit einer relationalen SQL-Datenbank verbinden. Das Plugin muss in der Datei module.xml
im Ordner <Serververzeichnis>\wildfly\modules\de\softproject\plugins\main
aktiviert werden.
Der erste Start des Profilings muss von einem Datenbankbenutzer ausgeführt werden, der über die Berechtigung zum Erstellen von Datenbanktabellen verfügt. Wenn alle erforderlichen Tabellen erstellt wurden, kann auf einen Benutzer mit weniger Berechtigungen umgestellt werden.
Wenn Sie das SQL Profiling aktivieren, wird das standardmäßige Profiling im Arbeitsspeicher nicht mehr verwendet.
So konfigurieren Sie das SQL Profiling
Erstellen Sie im Ordner
<Serververzeichnis>/configurations
die Dateisql_profiling_config.xml
.Fügen Sie den folgenden Inhalt ein.
XML<?xml version="1.0"?> <Configuration> <DatabaseConfiguration> <ConnectionString>JDBC-CONNECTION</ConnectionString> <UserName>USERNAME</UserName> <Password>PASSWORD</Password> <MaxPoolSize>36</MaxPoolSize> <MinPoolSize>8</MinPoolSize> <InitialPoolSize>24</InitialPoolSize> <!--OPTIONAL--> <AdditionalConnectionPoolConfig> <CheckoutTimeout>20000</CheckoutTimeout> </AdditionalConnectionPoolConfig> </DatabaseConfiguration> <WriteCycleTime> <Duration>10</Duration> <TimeUnit>SECONDS</TimeUnit> </WriteCycleTime> <KeepLogs> <Duration>100</Duration> <TimeUnit>DAYS</TimeUnit> </KeepLogs> <KeepCrashedProcessLogs> <Duration>100</Duration> <TimeUnit>DAYS</TimeUnit> </KeepCrashedProcessLogs> <RunCleanUp> <Duration>240</Duration> <TimeUnit>MINUTES</TimeUnit> </RunCleanUp> <FastDeleteEnabled>true</FastDeleteEnabled> <GlobalStepLogging>ALL</GlobalStepLogging> </Configuration>
Tragen Sie die benötigten Werte in die Datei
sql_profiling_config.xml
ein.
Konfiguration der Datenbank
Database Configuration
Element | Beschreibung | Mögliche Werte |
---|---|---|
| Wrapper für die Datenbankverbindung | |
| JDBC-Verbindungszeichenfolge zur Verbindung mit der Datenbank Weitere Einzelheiten finden Sie in der offiziellen JDBC-Datenbank-Dokumentation. |
|
| Benutzername für die Anmeldung bei der Datenbank |
|
| Passwort für die Anmeldung bei der Datenbank |
|
| Maximale Poolgröße des Verbindungspools. Empfohlener Wert: 15 |
|
| Minimale Poolgröße des Verbindungspools. |
|
| Initiale Größe des Verbindungspools. Empfohlener Wert: 8 |
|
| Zusätzliche Einstellungen für den zugrunde liegenden Verbindungspool. Weitere Informationen siehe: https:// |
|
| Legt fest, in welchen Zyklen die Daten in die SQL-Datenbank geschrieben werden. Daten werden nur zum gewählten Schreibzyklus (WriteCycle) in die Datenbank geschrieben. Stürzt der Server innerhalb des Zyklus ab, sind die ungeschriebenen Daten verloren. | Das Element enthält folgende Elemente:
|
| Legt fest, wie lange Einträge gespeichert werden, bevor diese automatisch bereinigt werden. | Das Element enthält folgende Elemente:
|
| Legt fest, wie lange Einträge für abgestürzte Prozesse gespeichert werden, bevor diese automatisch bereinigt werden. Abgestürzte Prozesse werden vom Element | Das Element enthält folgende Elemente:
|
| Legt fest, in welchen Zyklen die automatische Bereinigung durchgeführt wird. | Das Element enthält folgende Elemente:
|
| Löscht Protokolle auf schnellere Weise. Wenn dies aktiviert ist, hat die Konfiguration Mögliche Werte:
| |
| Definiert, welche Prozessschritte geloggt werden. Mögliche Werte:
Mit |
WriteCycleTime
Element | Beschreibung | Mögliche Werte |
---|---|---|
| Zeitraum, in dem die zwischengespeicherten Profiling-Daten in die Datenbank geschrieben werden |
|
| Einheit des Zeitraums |
|
KeepLogs
Element | Beschreibung | Mögliche Werte |
---|---|---|
| Zeitraum, wie lange die Profiling-Daten in der Datenbank aufbewahrt werden sollen |
|
| Einheit des Zeitraums |
|
KeepCrashedProcessLogs
Element | Beschreibung | Mögliche Werte |
---|---|---|
| Zeitraum, wie lange die Profiling-Daten über abgestürzte Prozesse in der Datenbank aufbewahrt werden sollen |
|
| Einheit des Zeitraums |
|
RunCleanUp
Element | Beschreibung | Mögliche Werte |
---|---|---|
| Zeitraum, nach dem die automatische Bereinigung die Prozessprotokolle löschen wird |
|
| Einheit des Zeitraums |
|
So installieren Sie das Plugin
Entpacken Sie die ZIP-Datei mit dem Plugin.
Kopieren Sie den Ordner
sql-profiling
in den Ordnerde\softproject\x4\plugins\
.Öffnen Sie die Datei
module.xml
im Ordner<Serververzeichnis>\wildfly\modules\de\softproject\x4\plugins\sql-profiling\main
.Kopieren Sie den in Zeile 2 angegebenen Plugin-Namen:
Öffnen Sie die Datei
module.xml
im Ordner<Serververzeichnis>\wildfly\modules\de\softproject\extensions\main
.Fügen Sie in der Datei
module.xml
folgende Zeile hinzu:<module name="de.softproject.x4.plugins.sql-profiling" export="true"/>
Die Datei sollte folgendermaßen aufgebaut sein:
Starten Sie den X4 Server neu.
Nach dem Neustart des X4 Servers steht Ihnen das Plugin zur Verfügung.