The Apache Network Integration provides real-time visibility into your team’s server performance and statistics. This integration is useful for teams that want to understand the number of requests made to your servers, workers in each state, cumulative server traffic, and much more. The Apache Network Integration works by ingesting and displaying data associated with the requests from clients and their corresponding responses back from the Apache Web Server. For example, server data is collected when a user makes a request to a web page and the corresponding response sends the requested components of the page back to the user.

For more information on the Apache Integration, navigate to the Apache Demo Project Repository.

Prerequisites

MW Host Agent

Middleware Host Agent (MW Agent) v1.6.1+ must be installed on your local machine. To install the MW Agent, see our Installation Guide.

Apache Web Server

Apache Web Server v2.4+. To install the latest Apache Web Server Version, navigate to the Apache HTTP Server Project.

Setup

Step 1: Enable Status Support

Gather server statistics by enabling the Apache Status Module. Add one of the following code snippets to your httpd.conf configuration file to whitelist your IP address or the host-agent and scrape data from the Apache Server:

IP Address
host-agent

httpd.conf

<Location "/server-status">
    SetHandler server-status
    Require ip <x.x.x.x>
</Location>

httpd.conf

<Location "/server-status">
    SetHandler server-status
    Require host <example.com>
</Location>

Step 2: Access Integrations

Log in to Middleware, navigate to the Installations Page in the bottom left corner, select Integrations and click Apache:

Step 3: Web Server Host

Add your Apache Web Server Host name, endpoint, and respective data collection interval:

Visualize Your Data

Default Apache Dashboard

Quickly access your Apache data with Middleware’s default Apache dashboard. Navigate to the Dashboard Builder and select the Apache Web Server Dashboard:

All Apache-related data is accessible in our widget builder through apache.* metrics. See below for a comprehensive list.

Metrics collected

Metric	Description
`apache.uptime`	Amount of time server has been running in seconds
`apache.current_connections`	Number of active connections currently attached to the HTTP server
`apache.workers`	Number of workers currently attached to the HTTP server
`apache.requests`	Number of requests serviced by the HTTP server per second
`apache.traffic`	Total HTTP server traffic
`apache.cpu.time`	Number of jiffs used by a process in a given category
`apache.cpu.load`	Current load of the CPU
`apache.load.1`	Average server load within the last minute
`apache.load.5`	Average server load within the last 5 minutes
`apache.load.15`	Average server load within the last 15 minutes
`apache.request.time`	Total time spent handling requests
`apache.scoreboard`	Number of workers in each state

Host Configuration

Input Field	Description
`endpoint`	URL of the httpd status endpoint
`collection_interval`	Interval that telemetry data is collected (default set to 10 sec interval)

Need assistance or want to learn more about Middleware? Contact us at support[at]middleware.io.

Middleware Docs

Apache

Prerequisites