Surveillance and Monitoring

In order to determine whether a PTV xServer is up and running, you can check the following:

• Connect to the alive port

  If the server does not respond, there is a general problem on an http level. The server can not be reached.

• Check the server processes

  In your process list, you should see the PTV xServer process structure consisting of a server and one or more xmodule (worker) processes. Worker processes should terminate if they find themselves orphaned; if not; you might have to terminate them manually. The server process will restart worker processes if they vanish.

• Open the PTV xServer dashboard

  If you have enabled the dashboard, you can go to the status monitor and have a look at the list of instances and at the request statistics. A high amount of restarts, rejected requests, or a very high average waiting or communication time ratio all deserve further investigation.

• Send a sample request

  You can send an example request to see whether the server responds within an acceptable period of time. To minimize interference with operations, do this in sparse intervals and select a request which is quick to calculate (such as searchLocations or calculateRoute with nearby coordinates or renderMap with a small image size).

• Check the logfiles

  The log files of the PTV xServer can be monitored for error messages and warnings. Errors are serious defects which can cause a shutdown of the PTV xServer, for example if the license is expired. Warnings can be temporary problems, for example if the job database is not up to date and a column is missing or if a feature layer binary is broken. Furthermore a warning is logged each day during the last 14 days before the license expires.

• Automated monitoring of the PTV xServer

  You can monitor the PTV xServer with the xruntime API. For example the expire date of the license with getLicenseInformation() or the memory statistics with getRuntimeInformation().

Module processes are monitored by the server process. There should be no need to monitor them externally. However, modules can be monitored using the web management console. Monitoring web services A web service represents a communication technology applied in computer networks. It provides an interface described in a machine-processable format, for example WSDL. will be part of future releases.