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 instructions.
- To upgrade the meter to the latest version - see instructions.
- 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://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 | Number of accesses |
Apache Total Bytes | Bytes transferred |
Apache Bytes per Request | Average bytes per request |
Apache CPU | CPU used by all workers |
Apache Busy Workers | Number of busy workers |
Apache Idle Workers | Number of idle workers |
Apache busy to idle ratio | Ratio of busy workers / (busy + idle workers) |
Apache Server
None