Confirming that the Data Collector is Running


Read more about Data Workbench’s End-of-life announcement.

Check whether the collector is running using different methods.

Recommended Frequency: Every 5-10 minutes

Using Site Test

One way to verify that the collector is running is to enable the Site Test function in the transmitter. When you enable Site Test, the transmitter periodically (every 60 seconds) sends a GET request to the web server on which the collector is running. If Site Test does not get a response from the web server, it writes an error message to syslog and sends an error message to the data workbench server (which is written to the sensor-log file).

If Site Test receives a response from the web server, it looks in the queue file for a packet from the web server. If the packet does not appear (indicating that the collector was not running to capture the event), Site Test writes an error message to syslog and sends an error message to Adobe (which also is written to the sensor-log file).

In the requests that Site Test sends to the web server, Site Test sets the User-Agent value to “ Sensor Test.” If you do not want these requests to appear in your dataset, add the “ Sensor Test” User-Agent to the Baseline Robots List.txt file or the Extended Robots List.txt file in the Lookups folder on the data workbench server.

To enable Site Test in the transmitter

  1. Locate the txlogd.conf file on the machine where Sensor is running and open it in a text editor.

  2. In the txlogd.conf file, locate the “SiteTest” line and configure it as shown below. If your txlogd.conf file does not include the “SiteTest” line, simply add the line to the end of the configuration file.

    SiteTest http, serverAddress, port, resource

    where serverAddress is the web server’s name or IP address, port is the server’s HTTP listening port, and resource is the specific resource that you want Site Test to request when testing the server. Note that resource can include a query string.

    Example: SiteTest http,localhost,80,/index.jsp

    To test multiple web servers, you simply specify multiple SiteTest lines.

Checking for a Cookie

Another way to verify that the collector is running on a web server is to check whether Sensor is setting a cookie in the responses that the web server is returning to clients. If the collector is working, the web server returns a “v1st” cookie.

It is possible to rename the cookie. If you have done so, you must look for the name specified, not v1st.

You can perform this check using an automated script or monitoring agent. For a sample script or additional help with this task, please contact Adobe Consulting Services.

On this page