Pimped Apache Status: Display the requests handled by an Apache server

Recommend this page to a friend!

Download

Info

Example

Screenshots

Files

Install with Composer

Download

Reputation

Support forum

Blog

Links

Ratings				Unique User Downloads		Download Rankings
Not enough user ratings				Total: 224		All time: 8,230 This week: 102

Version		License		PHP version		Categories
`pimped-apache-status` 1.28		GNU General Publi...		5.0		HTTP, PHP 5, System information

Description

Author

Axel Hahn

This package can be used to display the requests handled by an Apache web server.

It can parse the output of the regular Apache server status page to extract statistics of the Apache server resources usage as well details of the HTTP requests being currently handled.

The package renders the information in a way that is more readable than the regular server status page and allows to search and sort the listings.

It can merge the status of several servers that opens the possibility to identify a troubleshooter even on a load balanced Web site.

The Web based tool offers a multi-language, skinnable interface with a built-in updater.

It can also have several views, like for instance most requested files, domains, methods, most active IP, as well can export all views as JSON, XML or CSV.

Innovation Award

July 2015
Number 7

The Apache Web server comes with a module that can show the status of the Web server instance and the requests that it is serving.

However, the way that module presents the information is not very easy to understand and it is hard to figure certain types of information that would be helpful to determine the "health" of the Web server.

This class provides an alternative user interface to view the status of one or more Apache Web servers in a more readable way with the possibility to search and sort several types of listings.

Manuel Lemos

Axel Hahn

Performance

Level

Name:	Axel Hahn `<contact>`
Classes:	5 packages by Axel Hahn
Country:	Switzerland
Age:	52
All time rank:	2678	26 in Switzerland
Week rank:	170	4 in Switzerland

Level 1

Innovation award

Nominee: 2x

Example


<?php





/*


 * PIMPED APACHE-STATUS


 * 


 * view: update


 */





$sApproot=dirname(__DIR__);


$sZipfile = getTempdir() . '/__pimpapachestat-latest.zip';


$sTargetPath = $sApproot;


$sLatestUrl=$aEnv["links"]["update"]['download']['url'];





if (!array_key_exists('doinstall', $_GET)) {


    // ------------------------------------------------------------


    // step 1: welcome


    // ------------------------------------------------------------


    $sUpdateInfo=checkUpdate(true);


    $content = '<h3 id="h3' . md5($sServer) . '">' . $aUserCfg['icons']['update.php'] .' '. $aLangTxt["lblUpdate"] . '</h3>'


            . '<div class="subh3"><br>'


            . (hasNewVersion($sUpdateInfo)


                ?' '.$aLangTxt['lblUpdateNewerVerionAvailable'].'<br>'


                :'<div class="hintbox">'.$aLangTxt['lblUpdateNoNewerVerionAvailable'].'</div>'


                )


            . '<br>'


            . sprintf($aLangTxt["lblUpdateHints"], $sLatestUrl)


            . '</div>'


            . '<a href="' . getNewQs(array('doinstall' => 'download')) . '"'


            . ' class="btn btn-default"'


            . '>' . $aLangTxt["lblUpdateContinue"] . '</a>';


} else {


    switch ($_GET['doinstall']) {


        


        // ------------------------------------------------------------


        // step 2: download 


        // ------------------------------------------------------------


        case 'download':


            $content = '<h3 id="h3' . md5($sServer) . '">' . $aUserCfg['icons']['update.php'] .' '. $aLangTxt["lblUpdate"] . '</h3>'


                    . '<div class="subh3">';








            if (file_exists($sZipfile)) {


                unlink($sZipfile);


            }


            


            $sLatestVersionUrl = httpFollowUrl($sLatestUrl);


            


            $content.= $sLatestUrl . '<br> --&gt; GET ' . $sLatestVersionUrl;


            $sData = httpGet($sLatestVersionUrl);


            $content.=' ('.strlen($sData) . ')<br>';


        


            if (strlen($sData) > 100000) {


                file_put_contents($sZipfile, $sData);


                if (file_exists($sZipfile)) {


                    $content.='<br><strong>'.$aLangTxt['lblUpdateDonwloadDone'].'</strong>'


                            . '</div><a href="' . getNewQs(array('doinstall' => 'unzip')) . '"'


                            . ' class="btn btn-default"'


                            . '>' . $aLangTxt["lblUpdateContinue"] . '</a>';


                } else {


                    $content.=$aLangTxt['lblUpdateDonwloadFailed'] . '</div>';


                }


            } else {


                $content.=$aLangTxt['lblUpdateDonwloadFailed'] . '</div>';


            }





            break;


            


        // ------------------------------------------------------------


        // step 3: unzip downloaded file


        // ------------------------------------------------------------


        case 'unzip':


            $content = '<h3 id="h3' . md5($sServer) . '">' . $aUserCfg['icons']['update.php'] .' '. $aLangTxt["lblUpdate"] . '</h3>'


                    . '<div class="subh3">';


            $content.=sprintf($aLangTxt['lblUpdateUnzipFile'], $sZipfile, $sTargetPath) . '<br><br>';


            


            $zip = new ZipArchive;


            


            $res = $zip->open($sZipfile);


            if ($res === TRUE) {


                // extract it to the path we determined above


                $zip->extractTo($sTargetPath);


                $zip->close();


                $content.=$aLangTxt['lblUpdateUnzipOK'] . '</div>'


                    . '<a href="?"'


                        . ' class="btn btn-default"'


                        . '>' . $aLangTxt["lblUpdateContinue"] . '</a>';


                unlink($sZipfile);


            } else {


                $content.=$aLangTxt['lblUpdateUnzipFailed'] . '</div>';


            }


            break;


        /*


        case 'postunzip':


            $content = '<h3 id="h3' . md5($sServer) . '">' . $aLangTxt["lblUpdate"] . '</h3>'


                    . '<div class="h3">';


            $content.='</div>';


            break;


        */


        default:


            break;


    }


}








echo $content;

Details

----------------------------------------------------------------------

  Axel pimped the Apache-status

  http://www.axel-hahn.de/apachestatus.php
  http://sourceforge.net/projects/pimpapachestat/

  GNU GPL v 3.0
----------------------------------------------------------------------


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 8 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. 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.
     -- OR --
     checkout sources with svn client:
     cd [webroot-directory]
     svn checkout http://svn.code.sf.net/p/pimpapachestat/code/trunk apachestatus
  2. Allow your server to access the server-status page on the systems 
     you want to monitor
     <Location /server-status> 
       SetHandler server-status 
       order deny, allow 
       allow from 127.0.0.1
       allow from 192.168.123.4 # enter ip of your monitoring system
       deny from all 
     </Location> 
  3. Open http://localhost/apachestatus/ in your webbrowser.
  4. In ./conf/ directory: open config_user.php and setup the systems you want 
     to monitor. See config_default.php to see other thing you could override


CUSTOMIZATION
  * change or add language: see readme in subdirectory ./lang/
  * change theme: 
    - make copy ./templates/default/
    - make changes in style.css and out_html.php in your copy
    - set skin in ./conf/config_user.php:
      $aUserCfg = array(
        'skin' => 'name_of_subdir',
      );

  If you have a language or a theme to share then send it to me.


----------------------------------------------------------------------

Screenshots (4)

Files (99)

File	Role	Description
`admin` (1 file)
`classes` (15 files)
`config` (6 files)
`docs` (4 files)
`images` (5 files)
`javascript` (3 files, 3 directories)
`lang` (5 files)
`templates` (4 directories)
`tmp` (1 file)
`views` (9 files, 1 directory)
`history.txt`	Data	Documentation
`inc_config.php`	Example	Example script
`inc_functions.php`	Aux.	Sample output
`inc_menu.php`	Aux.	Auxiliary script
`inc_pagetemplate.php`	Example	Example script
`index.php`	Example	Sample output
`LICENSE`	Lic.	License text
`readme.md`	Doc.	Documentation
`readme.txt`	Doc.	Documentation
`upgrade.php`	Example	Example script

File	Role	Description
`ahwi-installer.class.php`	Class	Class source
`array2xml.class.php`	Class	Class source
`cdnorlocal-admin.class.php`	Class	Class source
`cdnorlocal.class.php`	Class	Class source
`configdata.class.php`	Class	Class source
`confighandler.class.php`	Class	Class source
`configserver.class.php`	Class	Class source
`data.tpl.php`	Data	Configuration script
`datarenderer.class.php`	Class	Class source
`html-bak.tpl.php`	Aux.	Auxiliary script
`html.tpl.php`	Data	Configuration script
`logger.class.php`	Class	Class source
`page.class.php`	Class	Class source
`primitivelogger.class.php`	Class	Class source
`serverstatus.class.php`	Class	Class source

File	Role	Description
`.htaccess`	Data	Auxiliary data
`config_default.php`	Conf.	Configuration script
`config_user_default.php`	Conf.	Example script
`internal-config_default.json`	Data	Auxiliary data
`internal-config_form.json`	Data	Auxiliary data
`internal-env.json`	Data	Auxiliary data

File	Role	Description
`simpledoc_datarenderer.html`	Doc.	Documentation
`simpledoc_page.html`	Doc.	Documentation
`simpledoc_primitivelogger.html`	Doc.	Documentation
`simpledoc_serverstatus.html`	Doc.	Documentation

File	Role	Description
`sort_asc.png`	Icon	Icon image
`sort_asc_disabled.png`	Icon	Icon image
`sort_both.png`	Icon	Icon image
`sort_desc.png`	Icon	Icon image
`sort_desc_disabled.png`	Icon	Icon image

File	Role	Description
`bootstrap3` (2 directories)
`datatables` (1 directory)
`font-awesome` (1 directory)
`counterhistory.class.js`	Data	Auxiliary data
`functions.js`	Data	Auxiliary data
`functions.min.js`	Data	Auxiliary data

File	Role	Description
`bootstrap-theme.min.css`	Data	Sample output
`bootstrap.min.css`	Data	Sample output

File	Role	Description
`bootstrap.min.js`	Data	Sample output
`npm.js`	Data	Sample output

File	Role	Description
`favicon.ico`	Data	Auxiliary data
`sort_asc.png`	Output	Sample output
`sort_asc_disabled.png`	Output	Sample output
`sort_both.png`	Output	Sample output
`sort_desc.png`	Output	Sample output
`sort_desc_disabled.png`	Output	Sample output

File	Role	Description
`jquery.dataTables.min.js`	Data	Sample output
`jquery.js`	Data	Sample output

File	Role	Description
`de.js`	Data	Auxiliary data
`de.php`	Conf.	Sample output
`en.js`	Data	Sample output
`en.php`	Conf.	Sample output
`readme.txt`	Doc.	Documentation

File	Role	Description
`data` (1 file)
`default` (4 files)
`ice` (2 files, 1 directory)
`summer` (2 files)

File	Role	Description
`out_html.php`	Aux.	Sample output
`requests.css`	Data	Sample output
`style.css`	Data	Sample output
`style.min.css`	Data	Auxiliary data

File	Role	Description
`images` (7 files)
`out_html.php`	Example	Sample output
`style.css`	Data	Auxiliary data

File	Role	Description
`bg_body.png`	Output	Sample output
`bg_h3.png`	Output	Sample output
`bg_hint.png`	Output	Sample output
`bg_menu.png`	Output	Sample output
`bg_navbtn.png`	Output	Sample output
`bg_th.png`	Output	Sample output
`bg_tile.png`	Output	Sample output

File	Role	Description
`admin` (6 files)
`allrequests.php`	Example	Sample output
`dump.php`	Example	Sample output
`help.php`	Example	Sample output
`install.php`	Example	Example script
`original.php`	Example	Sample output
`performance-check.php`	Example	Sample output
`selectserver.php`	Example	Example script
`serverinfos.php`	Example	Sample output
`update.php`	Example	Sample output

	pimped-apache-status-2018-04-27.zip 553KB
	pimped-apache-status-2018-04-27.tar.gz 528KB
	Install with Composer