Event Collector Overview

Event Collector is one of the components of TIBCO BPM Enterprise. It collects and correlates data on business process events.

External services can access the data in the central event database either by using the query API supplied, or by directly querying the database tables and views.

In order to facilitate direct read access to the central event database, this guide describes the Event Collection database tables and views. As well as using this reference guide, you should study the database tables and views themselves to see how the schema has been implemented by the manufacturers of the different databases supported.

Warning: It is very important that any access to the Event Collector database tables and views must be read-only. You must not try to insert or modify any data in the tables or views. Any attempt to do so could have unforeseen consequences on the behavior of TIBCO BPM Enterprise.
Note: When modifying rules files (ec-probe and ec-event ) note the following:
  • Rules must have globally unique names.
  • Check that channels are defined as channel name='abcde' target='target' qualifier='abcde (the qualifier is optional).

For further information:

  • On API access to the database, see TIBCO ActiveMatrix BPM Developer's Guide, in particular the chapter "Working with Events".
  • On clearing event data from the database tables, see the chapter "Housekeeping Tasks" in TIBCO ActiveMatrix BPM - BPM Administration.
  • For archiving event data, see the chapter "Archiving Messages" in TIBCO ActiveMatrix BPM - BPM Administration.
  • On removing rows from the database tables after forcibly removing a process, see the description of the BPM database cleanup utility bpm-db-cleanup in TIBCO ActiveMatrix BPM Troubleshooting Guide.
    Note: This database schema may change from version to version of TIBCO BPM Enterprise.