Administration & Troubleshooting
To test the installation, you will need to generate and send test messages, and then check that the messages were routed and processed correctly.
There are two approaches to generating and sending test messages:
You can instrument your applications either through code injection or by writing directly to an API.
PreEmptive offers two tools that can inject analytics messaging code into your applications: Dotfuscator for .NET and DashO for Java. You can get an evaluation of either of these tools from our website.
If you wish to start with instrumentation via injection, see our Instrumentation Injection Quick Start document and our Instrumentation injection tutorial video. Both of those resources focus on instrumentation injection for .NET with Dotfuscator, but DashO for Java users will still find the information valuable.
When configuring the instrumented application, use the Data Hub endpoint URL noted at the end of the Data Hub installation.
Edit the test message sender file and enter the endpoint URL for the Data Hub noted from the installer dialog. You will also need to supply GUIDs for the company ID and application ID where indicated.
Disable "Do Not Track" in your browser. This page, in the "For users" section, indicates whether your browser currently has Do Not Track enabled, and links to instructions on how to change it. (Note that if it is your preference for "Do Not Track" to be enabled, you should re-enable it after testing your installation.)
Once you have generated and sent some test messages, you should:
Wait approximately 90 seconds. The very first message received usually takes longer to process than later messages.
Check to see if data corresponding to the messages you sent shows up in the Workbench Portal (http://127.0.0.1:88). If you have the Portal page already open when you send the data, you will need to refresh the page for the data to show up. (Note that a browser refresh is only needed in the case where a new filter value is added, as is the case when you send your first messages to the Workbench.)
When you are finished testing, you can purge your test data from the Workbench by using the administration console provided with the Workbench. Note that using the
purge command will
purge all of your data, so please use this carefully.
Once you have instrumented an application, if you are not seeing data appear in the Workbench Portal, start by just refreshing the browser page, rather than using the "Apply" or "Refresh" button within the page.
If that doesn't work, we recommend using Fiddler to monitor network traffic both on the client-app machine and the Workbench machine. That will usually help you understand and resolve any instrumentation issues.
If you are sure that instrumentation data is reaching the Data Hub's endpoint, but you still aren't seeing it in the Portal, then there are a variety of tools that can help diagnose issues:
All application-level and some underlying errors will be reported in application-specific sections of the Windows Event Log. (They all start with "PA".)
RabbitMQ has a management console that shows the status of each configured queue. It can be found at http://localhost:15672/#/queues. Login as
If you wish to try restarting things, follow this order:
It is safe to restart RabbitMQ and/or MongoDB while the other components are still running.