Stackstate-Apache Integration

Overview

Get metrics from Apache in real time; graph them and correlate them with other relevant system metrics and events.

  • Visualize your web server performance
  • Correlate the performance of Apache with the rest of your applications

Setup

Installation

Make sure that mod_status is installed on your Apache server with ExtendedStatus set to on

Configuration

To capture Apache metrics you need to install the Stackstate agent.

  1. Configure the agent to connect to Apache. Edit /etc/sts-agent/conf.d/apache.yaml

    init_config:
    
    instances:
      - apache_status_url: http://example.com/server-status?auto
        # apache_user: example_user
        # apache_password: example_password
        tags:
          - instance:foo
        disable_ssl_validation: true # if you want to disable SSL cert validation
    

  2. Restart the agent

    sudo /etc/init.d/stackstate-agent restart
    

Validation

To ensure the integration is installed correctly, run the agent info command.

sudo /etc/init.d/stackstate-agent info

You should see something similar to the following if everything is working correctly:

Checks
======

  [...]

  apache
  ------
      - instance #0 [OK]
      - Collected 8 metrics & 0 events

Data Collected

Metrics

The following metrics are collected by default with the Apache integration:

apache.net.bytes
(gauge)
The total number of bytes served.
shown as byte
apache.net.bytes_per_s
(gauge)
The number of bytes served per second.
shown as byte
apache.net.hits
(gauge)
The total number of requests performed.
shown as request
apache.net.request_per_s
(gauge)
The number of requests performed per second.
shown as request
apache.performance.cpu_load
(gauge)
The percent of CPU used.
shown as percent
apache.performance.busy_workers
(gauge)
The number of workers serving requests.
shown as thread
apache.performance.idle_workers
(gauge)
The number of idle workers.
shown as thread
apache.performance.uptime
(gauge)
The amount of time the server has been running.
shown as second