Skip to main content

PTV xServer1: How to enable and extract request logs in PTV xServer 1 ?

Updated

Question

You want to analyze the current API consumption of your PTV xServer 1 installation and need to know how to activate logging and extract request logs for analysis.

 

Answer

PTV xServer 1 provides configurable logging options that allow you to record incoming requests and (optionally) responses.
By default, logging is kept at a minimal level and must be explicitly enabled to analyze request usage.

Default configuration

By default, logging is not continuously enabled:

  • logRequests = fatal
    → Requests are logged only in case of a crash.

  • logResponses = false
    → Responses are never logged.

This configuration is intended for critical error diagnostics only and is not sufficient to measure request volumes.

How to count the number of requests

To log all incoming requests:

  1. Open the configuration file of the relevant xServer module (e.g. XLocate, XRoute).

  2. Modify the following parameter: logRequests=true

This enables logging for all requests, such as:

  • /xlocate/ws/XLocate

  • /xroute/ws/XRoute

Important:
This change must be applied individually in the configuration file of each module you want to monitor.
Restart the xServer service to apply the configuration changes.
You can send these log files to us for analysis.

We will count the log entries containing requests to estimate the API consumption.

Additions hints

Optional: Enable response logging

Enabling request logging can generate a significant amount of data.

We strongly recommend:

  • Limiting the logging to a short time period

  • Archiving or deleting the log files after analysis

  • If required, you can also enable response logging: logResponses=true
     Not recommended in production, as it generates a very large volume of logs and may impact performance.

 

Related articles

PTV xServer: How can I log requests and responses PTV xServer (1 & 2)?