Skip to content

Latest commit

 

History

History
114 lines (82 loc) · 3.99 KB

collectd-apache.md

File metadata and controls

114 lines (82 loc) · 3.99 KB

collectd/apache

Monitors Apache webservice instances using the information provided by mod_status.

See https://github.com/signalfx/integrations/tree/master/collectd-apache

Sample YAML configuration:

monitors:
 - type: collectd/apache
   host: localhost
   port: 80

If mod_status is exposed on an endpoint other than /mod_status, you can use the url config option to specify the path:

monitors:
 - type: collectd/apache
   host: localhost
   port: 80
   url: "http://{{.Host}}:{{.Port}}/server-status?auto"

Monitor Type: collectd/apache

Monitor Source Code

Accepts Endpoints: Yes

Multiple Instances Allowed: Yes

Configuration

Config option Required Type Description
host yes string The hostname of the Apache server
port yes integer The port number of the Apache server
name no string This will be sent as the plugin_instance dimension and can be any name you like.
url no string The URL, either a final URL or a Go template that will be populated with the host and port values. (default: http://{{.Host}}:{{.Port}}/mod_status?auto)
username no string
password no string

Metrics

The following table lists the metrics available for this monitor. Metrics that are marked as Included are standard metrics and are monitored by default.

Name Type Included Description
apache_bytes cumulative ✔ Bytes served by Apache
apache_connections gauge ✔ Connections served by Apache
apache_idle_workers gauge ✔ Apache workers that are idle
apache_requests cumulative ✔ Requests served by Apache
apache_scoreboard.closing gauge Number of workers in the process of closing connections
apache_scoreboard.dnslookup gauge Number of workers performing DNS lookup
apache_scoreboard.finishing gauge Number of workers that are finishing
apache_scoreboard.idle_cleanup gauge Number of idle threads ready for cleanup
apache_scoreboard.keepalive gauge Number of keep-alive connections
apache_scoreboard.logging gauge Number of workers writing to log file
apache_scoreboard.open gauge ✔ Number of worker thread slots that are open
apache_scoreboard.reading gauge Number of workers reading requests
apache_scoreboard.sending gauge Number of workers sending responses
apache_scoreboard.starting gauge Number of workers starting up
apache_scoreboard.waiting gauge Number of workers waiting for requests

To specify custom metrics you want to monitor, add a metricsToInclude filter to the agent configuration, as shown in the code snippet below. The snippet lists all available custom metrics. You can copy and paste the snippet into your configuration file, then delete any custom metrics that you do not want sent.

Note that some of the custom metrics require you to set a flag as well as add them to the list. Check the monitor configuration file to see if a flag is required for gathering additional metrics.

metricsToInclude:
  - metricNames:
    - apache_scoreboard.closing
    - apache_scoreboard.dnslookup
    - apache_scoreboard.finishing
    - apache_scoreboard.idle_cleanup
    - apache_scoreboard.keepalive
    - apache_scoreboard.logging
    - apache_scoreboard.reading
    - apache_scoreboard.sending
    - apache_scoreboard.starting
    - apache_scoreboard.waiting
    monitorType: collectd/apache

Dimensions

The following dimensions may occur on metrics emitted by this monitor. Some dimensions may be specific to certain metrics.

Name Description
plugin_instance Set to whatever you set in the name config option.