Files
apache-http-server/modules/cluster/README.heartbeat
Paul Querna 3680a77cba Add two new modules to handle load balancing across multiple apache servers
within the same datacenter.

mod_heartbeat generates multicast status messages with the current number of 
clients connected, but the formated can easily be extended to include other 
things.

mod_heartmonitor collects these messages into a static file, which then can be 
used for other modules to make load balancing decisions on.

This module was originally written at Joost by Sander Striker, Justin 
Erenkrantz, and myself.  We have been given permission by our employer to 
contribute this module.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@721952 13f79535-47bb-0310-9956-ffa450edef68
2008-12-01 02:55:14 +00:00

34 lines
996 B
Plaintext

mod_heartbeat
Broadcasts the current Apache Connection status over multicast.
Example Configuration:
HeartbeatAddress 239.0.0.1:27999
Dependencies:
mod_status must be either a static module, or if a dynamic module, it must be
loaded before mod_heartbeat.
Consuming:
Every 1 second, this module generates a single multicast UDP packet,
containing the number of busy and idle workers.
The packet is a simple ASCII format, similiar to GET query parameters in UDP.
An Example packet:
v=1&ready=75&busy=0
Consumers should handle new variables besides busy and ready, separated by '&'
being added in the future.
Misc:
The interval of 1 seconds is controlled by the HEARTBEAT_INTERVAL
compile time define. This is not currently tunable at run time. To make this
module send the status packet more often, you must add to the CFLAGS used to
compile the module to include:
-DHEARTBEAT_INTERVAL=3
Would cause the broadcasts to be sent every 3 seconds.