Collects metrics from a Apache HTTP server instance. See video walkthrough.
OS | Linux | Windows | SmartOS | OS X |
---|---|---|---|---|
Supported | v | v | v | v |
- To install new meter go to Settings->Installation or see instructons.
- To upgrade the meter to the latest version - see instructons.
Runtime | node.js | Python | Java |
---|---|---|---|
Required | + |
- How to install node.js?
- Apache HTTP Server must be configured to run the
server-stats
module.
- The Boundary Apache HTTP Server plugin depends on the
server-stats
module for collecting metrics. The sections below provide the procedures to enable and configure theserver-stats
module.
- Modify the Apache HTTP Server
httpd.conf
by adding the following:<Location /server-status> SetHandler server-status </Location>
- Create as password file to secure the endpoint. The example shown here is using the path
/etc/httpd/my_password_file
.$ sudo htpasswd -c /etc/httpd/my_password_file
- Enable authentication by modifying the
<Location/>
added previously as shown here :<Location /server-status> SetHandler server-status AuthType basic AuthName "Apache status" AuthUserFile /etc/httpd/my_password_file Require valid-user </Location>
- Restart Apache HTTP server reload the
httpd.conf
configuration. - Verify that statistics are being collected by visiting http:https://yourserver.com/server-status
- To also capture the 'requests per second' metric, add
ExtendedStatus On
outside of your<Location />
block:<Location /server-status> SetHandler server-status AuthType basic AuthName "Apache status" AuthUserFile /etc/httpd/my_password_file Require valid-user </Location> ExtendedStatus On
Field Name | Description |
---|---|
Server-Status URL | The URL endpoint of where the Apache HTPP server statistics are hosted. |
Username | If the URL is password protected, what username should the plugin use to authenticate |
Password | If the URL is password protected, what password should the plugin use to authenticate |
Poll Interval | How often (in milliseconds) to poll for metrics (default: 1000). |
Source | Name identifying the specific instance of Apache HTTP server which is displayed in dashboards |
Tracks the following metrics for apache
Metric Name | Description |
---|---|
Apache Requests | The number of Apache Accesses |
Apache Total Bytes | bytes transferred |
Apache Bytes per Request | average bytes per request |
Apache CPU | |
Apache Busy Workers | the number of busy workers |
Apache Idle Workers | the number of idle workers |
Apache busy to idle ratio | The ratio of busy workers / (busy + idle workers) |
Apache Server
None