Skip to content

Latest commit

 

History

History

README.md

Apache Web Server Receiver

The Apache Web Server Receiver fetches stats from an Apache Web Server instance using the server-status?auto endpoint.

Status
Stability beta: metrics
Distributions contrib
Issues Open issues Closed issues
Code coverage codecov
Code Owners @colelaven, @ishleenk17
Emeritus @djaglowski

Prerequisites

This receiver supports Apache Web Server version 2.4.13+.

mod_status module

In order to receive server statistics, you must configure the server's httpd.conf file to enable status support.

Configuration

The following settings are required:

  • endpoint (default: http://localhost:8080/server-status?auto): The URL of the httpd status endpoint

The following settings are optional:

  • collection_interval (default = 10s): This receiver collects metrics on an interval. This value must be a string readable by Golang's time.ParseDuration. Valid time units are ns, us (or µs), ms, s, m, h.
  • initial_delay (default = 1s): defines how long this receiver waits before starting.

Example Configuration

receivers:
  apache:
    endpoint: "http://localhost:8080/server-status?auto"

The full list of settings exposed for this receiver are documented in config.go with detailed sample configurations in testdata/config.yaml.

Metrics

Details about the metrics produced by this receiver can be found in metadata.yaml