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-statsmodule.
- The Boundary Apache HTTP Server plugin depends on the
server-statsmodule for collecting metrics. The sections below provide the procedures to enable and configure theserver-statsmodule.
- Modify the Apache HTTP Server
httpd.confby 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.confconfiguration. - Verify that statistics are being collected by visiting http://yourserver.com/server-status
- To also capture the 'requests per second' metric, add
ExtendedStatus Onoutside 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