Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Add the artifact with groupId "com.blueriq" and artifactId "blueriq-component-trace-sql-store" as a dependency to your Blueriq runtime POM file if you want to depend on it.

Configuration

Database

Scripts to create the required database content are provided for the following databases:

  • SQL Server
  • Oracle
  • H2 (we do not recommend using a H2 database in production environments)
Info

For customers that are upgrading an existing version of Blueriq, database upgrade scripts are provided in the Upgrade instructions when applicable.

UI Text Box
typewarning

Please make sure the trace-sql-store has a separate datasource. Using the same datasource for other components is known to cause errors.

Use the following steps to configure the datasource:

...

The

...

Code Block
languagepowershell
titleapplication-externaldatasources.properties
blueriq.datasource.trace-sql-store.url=jdbc:sqlserver://<database_url>:<port>;databaseName=bq_comments;instance=SQL_EXPRESS
blueriq.datasource.trace-sql-store.username=<username>
blueriq.datasource.trace-sql-store.password=<password>
blueriq.datasource.trace-sql-store.driverClassName=com.microsoft.sqlserver.jdbc.SQLServerDriver
blueriq.hibernate.trace-sql-store.hbm2ddl.auto=validate
blueriq.hibernate.trace-sql-store.dialect=org.hibernate.dialect.SQLServer2012Dialect

...

Code Block
languagepowershell
titleapplication-jndidatasources.properties
blueriq.datasource.trace-sql-store.jndiName=java:/comp/env/jdbc/blueriqTrace
blueriq.hibernate.trace-sql-store.hbm2ddl.auto=validate
blueriq.hibernate.trace-sql-store.dialect=org.hibernate.dialect.SQLServer2012Dialect

...

datasource name is trace-sql-store.

Include Page
_DatasourceConfiguration
_DatasourceConfiguration

...

Supported dialects:

  • org.hibernate.dialect.SQLServer2012Dialect (for SQL Server)
  • org.hibernate.dialect.Oracle12cDialect (for Oracle)
  • org.hibernate.dialect.H2Dialect (for H2) (we do not recommend using a H2 database in production environments)

Supported hbm2ddl.auto values:

...

Consume trace events

The Trace SQL Store component can store trace messages directly in the database, but it is also possible to decouple the storage of trace messages using the Trace Event Publisher Component to publish trace events to a queue and then consume them using this component.

...