Skip to main content

​
Apache Receiver

Status Available in: contrib Maintainers: @colelaven, @ishleenk17 Source: opentelemetry-collector-contrib

​
Supported Telemetry

Metrics

​
Overview

​
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

​
Metrics

Metric NameDescriptionUnitTypeAttributes
✅ apache.connections.asyncThe number of connections in different asynchronous states reported by Apache’s server-status.{connections}Gaugeconnection_state
✅ apache.cpu.loadCurrent load of the CPU.%Gauge
✅ apache.cpu.timeJiffs used by processes of given category.{jiff}Countercpu_level, cpu_mode
✅ apache.current_connectionsThe number of active connections currently attached to the HTTP server.{connections}UpDownCounter
✅ apache.load.1The average server load during the last minute.%Gauge
✅ apache.load.15The average server load during the last 15 minutes.%Gauge
✅ apache.load.5The average server load during the last 5 minutes.%Gauge
✅ apache.request.timeTotal time spent on handling requests.msCounter
✅ apache.requestsThe number of requests serviced by the HTTP server per second.{requests}Counter
✅ apache.scoreboardThe number of workers in each state.{workers}UpDownCounterscoreboard_state
✅ apache.trafficTotal HTTP server traffic.ByCounter
✅ apache.uptimeThe amount of time that the server has been running in seconds.sCounter
✅ apache.workersThe number of workers currently attached to the HTTP server.{workers}UpDownCounterworkers_state

​
Attributes

Attribute NameDescriptionTypeValues
connection_stateThe asynchronous connection state reported by Apache’s server-status.stringwriting, keepalive, closing
levelLevel of processes.stringself, children
modeMode of processes.stringsystem, user
stateThe state of a connection.stringopen, waiting, starting, reading, sending, keepalive, dnslookup, closing, logging, finishing, idle_cleanup, unknown
stateThe state of workers.stringbusy, idle

​
Resource Attributes

Attribute NameDescriptionTypeEnabled
apache.server.nameThe name of the Apache HTTP server.string✅
apache.server.portThe port of the Apache HTTP server.string✅

​
Configuration

​
Example Configuration

apache:
  endpoint: "http://localhost:8080/server-status?auto"
  collection_interval: 10s
Last generated: 2026-04-13