ePages Application Server Monitor 6.17.14
Created: 6.0.0; Updated: 6.17.5

This program monitors the activity of the ePages Request Routers and Application Servers.

The server monitor is a CGI application, therefore it requires a web server. The program is installed in the directory $EPAGES_SHARED/Monitor.

Table of Contents

1 Installation on Linux

Environment variable APACHE_MONITOR_ALLOW in /etc/apache2-epages/envvars defines what hosts can access the server monitor. Value is a space-separated list of hostnames/IPs. After changing ACHE_MONITOR_ALLOW the web server must be restarted (reload is not sufficient).

To run the monitor server, point your web browser to:

  http://<your web server>/Monitor/spy.pl

2 Page: Cache Statistics

Pool
application server pool
ServerIP:Port
application server IP address and port number
PID
application server process id
Prio
application server priority (default=0)
Status
application server status
idle
application server is ready to process requests
down
application server is not connected to the request router
assigned
application server has been assigned to a request, but is not yet processing it
working
application server is processing a request
monitor
application server is processing a length request, such as export or import. The processing time will not be included in performance statistics.
LastContact
seconds since the last request or heartbeat
CacheItemCount
number of pending cache items
CacheItems
actual cache item data

3 Page: Server

Pool
name of the application server pool
ServerIP:Port
application server IP address and port number
PID
application server process id
Prio
application server priority (default=0)
Status
application server status (see above)
LastContact
seconds since the last request or heartbeat
Hits
number of requests that have been processed so far
LongReq
number of requests with a processing time of more than 5 seconds
MeanReq
number of requests with a processing time of less than 5 seconds and also excluding requests that are marked as 'monitor'
MeanTime
average processing time per request in milliseconds (counting only requests that fall into the MeanReq category)
IdleTime
idle time since since processing the last request or startup
Store
store name of the most recently processed request
Site
GUID of the site (e.g. shop) of the most recently processed request
ClientIP
client IP address
Ext
script name extension of the most recently processed request
URL
URL of the most recently processed request

4 Page: Pools

Name
name of the application server pool
CountServer
number of application servers
Idle
number of application servers in state 'idle'
Assigned
number of application servers in state 'assigned'
Working
number of application servers in state 'working'
Monitor
number of application servers in state 'monitor'
Down
number of application servers in state 'down'
Hits
total number of sucessfully routed request
UniqueMisses
number of request that were delayed, because all application servers were already in use, multiple tries of the same request where count at one
Misses
number of request that were delayed, because all application servers were already in use
Timeouts
number of requests running in time out (heavy traffic)
The following columns provide statistics about which strategy was uses to assign application servers to requests:

ClientIP
application server was assigned based on the IP address of the client
Site
application server was assigned based on the URL of the shop
LastUse
the application server with maximum idle time was used
The following columns provide statistics about rejected requests:

LimitExt
too many concurrent request for a script name extension
LimitSite
too many concurrent request for a site by pool-wide limit
LimitSpecial
too many concurrent request for a site with an individual limit
LimitClient
too many concurrent request from the same client ip address

5 Page: Request Routers

ServerIP:Port
request router IP address and port number (Message Center)
Status - request router status:
new
request router was just started, no message has been sent yet
down
last message was sent successfully
up
last message exchange failed
Last Ping
seconds since the last successful message exchange

Copyright ePages GmbH 2015