11. Audit
File auditor
First install the audit feature:
smx@root:/> features/install nmr-audit
Then create a file named deploy/servicemix-file-audit.xml
with the following content:
<beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:osgi="http://www.springframework.org/schema/osgi" xsi:schemaLocation=" http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/osgi http://www.springframework.org/schema/osgi/spring-osgi.xsd"> <bean class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer" /> <bean id="file-auditor" class="org.apache.servicemix.nmr.audit.file.FileAuditor"> <property name="directory" value="${servicemix.base}/data/audit/file" /> </bean> <osgi:service ref="file-auditor"> <osgi:interfaces> <value>org.apache.servicemix.nmr.api.event.Listener</value> <value>org.apache.servicemix.nmr.api.event.ExchangeListener</value> </osgi:interfaces> </osgi:service> <osgi:service ref="file-auditor"> <osgi:interfaces> <value>org.apache.servicemix.nmr.audit.AuditorMBean</value> </osgi:interfaces> </osgi:service> </beans>
Here you go, all exchanges will be logged into the data/audit/file
directory.
JDBC auditor
First install the audit feature:
smx@root:/> features/install nmr-audit
Then, install the required database (we use HSQLDB here). As there is no OSGi bundle for this database, we use the wrap
url handler to create one on the fly.
smx@root:/> osgi/install -s wrap:mvn:hsqldb/hsqldb/1.8.0.7
Then create a file named deploy/servicemix-jdbc-audit.xml
with the following content. This example uses the HSQLDB database, but you can configure any DataSource.
<beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:osgi="http://www.springframework.org/schema/osgi" xsi:schemaLocation=" http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/osgi http://www.springframework.org/schema/osgi/spring-osgi.xsd"> <bean class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer" /> <bean id="jdbc-auditor" class="org.apache.servicemix.nmr.audit.jdbc.JdbcAuditor"> <property name="dataSource" ref="dataSource" /> </bean> <bean id="dataSource" class="org.hsqldb.jdbc.jdbcDataSource"> <property name="database" value="jdbc:hsqldb:file:${servicemix.base}/data/audit/jdbc/hsqldb" /> <property name="user" value="sa" /> </bean> <osgi:service ref="jdbc-auditor"> <osgi:interfaces> <value>org.apache.servicemix.nmr.api.event.Listener</value> <value>org.apache.servicemix.nmr.api.event.ExchangeListener</value> </osgi:interfaces> </osgi:service> <osgi:service ref="file-auditor"> <osgi:interfaces> <value>org.apache.servicemix.nmr.audit.AuditorMBean</value> </osgi:interfaces> </osgi:service> </beans>
Lucene indexation
Any auditor can be wrapped in a lucene auditor to provide indexation and search in audited exchanges.
Note that prior to installing the nmr-audit
feature, you need to install lucene bundle:
smx@root:/> osgi/install -s wrap:mvn:org.apache.lucene/lucene-core/2.4.1
If the feature has already been installed, you need to use the osgi/refresh
command.
smx@root:/> osgi/refresh
See the configuration below:
<beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:osgi="http://www.springframework.org/schema/osgi" xsi:schemaLocation=" http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/osgi http://www.springframework.org/schema/osgi/spring-osgi.xsd"> <bean class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer" /> <bean id="jdbc-auditor" class="org.apache.servicemix.nmr.audit.jdbc.JdbcAuditor"> <property name="dataSource" ref="dataSource" /> </bean> <bean id="lucene-auditor" class="org.apache.servicemix.nmr.audit.lucene.LuceneAuditor"> <property name="delegatedAuditor" ref="jdbc-auditor" /> <property name="luceneIndexer"> <bean class="org.apache.servicemix.nmr.audit.lucene.LuceneIndexer"> <property name="directoryName" value="${servicemix.base}/data/audit/lucene/" /> </bean> </property> </bean> <bean id="dataSource" class="org.hsqldb.jdbc.jdbcDataSource"> <property name="database" value="jdbc:hsqldb:file:${servicemix.base}/data/audit/jdbc/hsqldb" /> <property name="user" value="sa" /> </bean> <osgi:service ref="lucene-auditor"> <osgi:interfaces> <value>org.apache.servicemix.nmr.api.event.Listener</value> <value>org.apache.servicemix.nmr.api.event.ExchangeListener</value> </osgi:interfaces> </osgi:service> <osgi:service ref="lucene-auditor"> <osgi:interfaces> <value>org.apache.servicemix.nmr.audit.AuditorMBean</value> </osgi:interfaces> </osgi:service> </beans>
Commands
A few commands are available to access the audited exchnanges:
audit/count audit/ids audit/exchanges audit/delete audit/find
The last command audit/find
only works if lucene has been set up as shown above.