Apache Integration - Atatus Docs

The Apache integration allows you to monitor your Apache HTTP Server with the Atatus Infrastructure Agent. The agent reads metrics from the Apache server-status page and picks up the error and access logs from the same configuration file. Use this integration to:

Track request throughput such as requests per second and bytes served.
Monitor worker usage with the number of busy and idle workers.
Observe connections, CPU load, and server uptime.
Collect Apache error and access logs.

Setup

The Apache integration is bundled with the Atatus Infrastructure Agent. The agent polls Apache over HTTP, so the server-status page has to be reachable before any metric arrives. It comes from the mod_status module. On Debian and Ubuntu, enable the module with:

sudo a2enmod status

Then open /etc/apache2/mods-enabled/status.conf and make sure it exposes the status page:

<Location "/server-status">
    SetHandler server-status
    Require local
</Location>

Reload Apache to apply the change:

sudo systemctl reload apache2

On RHEL, CentOS, and Amazon Linux, mod_status is loaded by default and the service is named httpd, so run sudo systemctl reload httpd instead.

Note the port Apache listens on, because the configuration below needs it.

Configuration

Metrics

Add the following configuration to /etc/atatus-infra-agent/conf.d/apache.d/apache.yml:

metrics:
  - hosts: ["http://127.0.0.1:8080"]
    # Path to server status. Default server-status
    metrics_path: "server-status"
    username: user
    password: pass
    enabled: true                    # set false to disable

Check these before you save:

The port in hosts must be the port Apache listens on. 8080 is a placeholder, not a default Apache port.
metrics_path is the location of the status page. Keep server-status unless you exposed it at a different path.
username and password are only needed if you protect the status page with HTTP basic authentication. Remove both lines if you don’t.

Logs

Logs are configured in the same file as metrics. First, turn on log collection for the agent in /etc/atatus-infra-agent/atatus.yml:

logs_enabled: true

Then add a logs section to /etc/atatus-infra-agent/conf.d/apache.d/apache.yml:

logs:
  - type: error
  - type: access

  ## If you have custom log path, you can use below log section and comment above types.
  # - type: error
  #   paths:
  #      - /var/log/apache2/error.log*
  #      - /var/log/httpd/error_log*
  #   source: apache
  #   service: apache

  # - type: access
  #   paths:
  #      - /var/log/apache2/access.log*
  #      - /var/log/apache2/other_vhosts_access.log*
  #      - /var/log/httpd/access_log*
  #   source: apache
  #   service: apache

The two default types, error and access, pick up the standard Apache log paths. If your logs are in a different location, comment out the two default types and uncomment the entries below them. Then change paths to match your log files.

Verify Metrics

You can verify that the status page is reachable by calling it manually:

curl "http://127.0.0.1:8080/server-status?auto"

Replace 8080 with your Apache port. Add -u <USER>:<PASSWORD> if the page uses basic authentication.

Restart the Agent

After configuration, restart the Atatus Infrastructure Agent:

sudo service atatus-infra-agent restart

Metrics

These are the metrics the integration collects from the server-status page:

Name	Description	Type
apache.status.requests_per_sec	Requests per second.	`float`
apache.status.cpu.load	CPU load.	`float`
apache.status.workers.idle	Number of idle workers.	`long`
apache.status.workers.busy	Number of busy workers.	`long`
apache.status.connections.async.writing	Async connections in the writing state.	`long`
apache.status.connections.async.keep_alive	Async connections in the keep-alive state.	`long`
apache.status.connections.async.closing	Async connections in the closing state.	`long`
apache.status.connections.total	Total connections.	`long`
apache.status.uptime.server_uptime	Server uptime in seconds.	`long`
apache.status.total_kbytes	Total number of kilobytes served.	`long`
apache.status.bytes_per_sec	Bytes per second.	`float`

​Setup

​Configuration

​Metrics

​Logs

​Verify Metrics

​Restart the Agent

​Metrics

Setup

Configuration

Metrics

Logs

Verify Metrics

Restart the Agent

Metrics