SQL Profiling 1.0.0

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 ist verfügbar in <Serververzeichnis>\wildfly\modules\de\softproject\x4\plugins, aber muss in der Datei module.xml im Ordner <server_directory>\wildfly\modules\de\softproject\plugins\main aktiviert werden.

Wichtig!

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 Datei sql_profiling_config.xml.

Fügen Sie den folgenden Inhalt ein.

XML

<?xml version="1.0"?>
<Configuration>
  <DatabaseConfiguration>
	<ConnectionString></ConnectionString>
	<UserName></UserName>
	<Password></Password>
  </DatabaseConfiguration>
	<WriteCycle>
		<Duration></Duration>
		<TimeUnit></TimeUnit>
	</WriteCycle>
	<KeepLogs>
		<Duration></Duration>
		<TimeUnit></TimeUnit>
	</KeepLogs>
	<KeepCrashedProcessLogs>
		<Duration></Duration>
		<TimeUnit></TimeUnit>
	</KeepCrashedProcessLogs>
	<RunCleanUp>
		<Duration></Duration>
		<TimeUnit></TimeUnit>
	</RunCleanUp>
</Configuration>

Tragen Sie die benötigten Werte in die Datei sql_profiling_config.xml ein.

DatabaseConfiguration

Element	Beschreibung	Mögliche Werte
`ConnectionString`	JDBC-Verbindungszeichenfolge zur Verbindung mit der Datenbank Weitere Einzelheiten finden Sie in der offiziellen JDBC-Datenbank-Dokumentation.	Verbindungs-URL für die JDBC-Datenbank
`UserName`	Benutzername für die Anmeldung bei der Datenbank	Beliebiger String
`Password`	Passwort für die Anmeldung bei der Datenbank	Beliebiger String
`WriteCycle`	Legt fest, in welchen Zyklen die Daten in die SQL-Datenbank geschrieben werden.	Das Element enthält folgende Elemente: `Duration` `TimeUnit`
`KeepLogs`	Legt fest, wie lange Einträge gespeichert werden, bevor diese automatisch bereinigt werden.	Das Element enthält folgende Elemente: `Duration` `TimeUnit`
`KeepCrashedProcessLogs`	Legt fest, wie lange Einträge für abgestürzte Prozesse gespeichert werden, bevor diese automatisch bereinigt werden. Abgestürzte Prozesse werden vom Element `KeepLogs` nicht erfasst.	Das Element enthält folgende Elemente: `Duration` `TimeUnit`
`RunCleanUp`	Legt fest, in welchen Zyklen die automatische Bereinigung durchgeführt wird.	Das Element enthält folgende Elemente: `Duration` `TimeUnit`

WriteCycle

Element	Beschreibung	Mögliche Werte
`Duration`	Zeitspanne	Ganzzahl
`TimeUnit`	Einheit der Zeitspanne	`SECONDS` `MINUTES` `HOURS` `DAYS`

KeepLogs

Element	Beschreibung	Mögliche Werte
`Duration`	Zeitspanne	Ganzzahl
`TimeUnit`	Einheit der Zeitspanne	`SECONDS` `MINUTES` `HOURS` `DAYS`

KeepCrashedProcessLogs

Element	Beschreibung	Mögliche Werte
`Duration`	Zeitspanne	Ganzzahl
`TimeUnit`	Einheit der Zeitspanne	`SECONDS` `MINUTES` `HOURS` `DAYS`

RunCleanUp

Element	Beschreibung	Mögliche Werte
`Duration`	Zeitspanne	Ganzzahl
`TimeUnit`	Einheit der Zeitspanne	`SECONDS` `MINUTES` `HOURS` `DAYS`

So installieren Sie das Plugin

Ö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\plugins\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.