Pimped Apache status page; PHP web application that renders server-status page and makes it readable; even for load balanced websites
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
admin
classes
config
docs
images
javascript
lang
templates
tmp
vendor
views
.gitignore
LICENSE
history.txt
inc_config.php
inc_functions.php
inc_menu.php
inc_pagetemplate.php
index.php
readme.md
upgrade.php

readme.md

Axel pimped the Apache-status

Ressources:


ABOUT

The default apache status shows you information about current Apache activity. But these server-status pages are difficult to read.

The pimped Apache status makes the Apache server status readable, sortable and searchable. The pimped Apache status can merge the status of several servers that opens the possibility to identify the troubleshooter in a load balanced website much more easily. Btw: I use the script to fetch the status from 20+ servers.

The output uses jQuery and the plugin datatable to search and sort the data.

LICENSE

GNU GPL v 3.0

REQUIREMENTS

  • On the system you want to install the pimped Apache status:
    • any webserver with php 5 (with curl; no database is needed)
  • On all webservers you want to monitor:
    • apache 2.x
    • installed module mod_status and ExtendedStatus On
    • permission for the monitoring server to request the the alias /server-status (see below)

INSTALL

(1)

Download the software https://sourceforge.net/projects/pimpapachestat/files/latest/download Extract the files somewhere below webroot on your webserver. You can put to any subdirectory. It is not a must to have it in the webroot.

(2)

Allow your server to access the server-status page on the systems you want to monitor, i.e. in apache 2.4 syntax:

<Location /server-status> 
  SetHandler server-status 
  Require ip 127.0.0.1
  Require ip 192.168.123.4 # enter ip of your monitoring system
</Location>

(3)

Open http://localhost/apachestatus/ in your webbrowser.

(4)

Go to the admin subdirectory: http://localhost/apachestatus/admin/ There you can add groups and servers. (You can change the settings in the json files in ./config/ too).

UPGRADE from version 1.x

A new local version will be detected in the webbrowser. Follow the upgrade link or open directly http://localhost/apachestatus/upgrade.php

On CLI or for automation execute

php [installdir]/upgrade.php

CUSTOMIZATION

You can setup and group servers to monitor, define skins, templates and more. See the Docs::Customization.

You can disable the access to admin in your apache config with a deny rule. All settings and configured servers you find in json files below the config subdirectory:

  • config_servers.json
  • config_user.json