Skip to content

scottwilliambeasley/topache

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

topache

An apache monitoring tool, similar in format to the common Unix utility, top.

Point it to your apache log files in order to display request statistics regarding your domains in real time.

This is a Python 3 script. Simply clone the repo, cd to it, run python3 topache.py $LOG_LOCATION1 $LOG_LOCATION2.

Dependencies

Topache depends on the following things:

  • Python 3. Do not attempt to use it with Python 2.
  • The user_agents package ( install it with pip3 install user_agents )
  • A modified version of the apache_log_parser package. I've since modified it as it breaks in Python 3. No action should be needed to use it as it is included with the repo itself.

Please also note, it is imperative that you implement the %v directive as part of your Apache log format for proper statistic gathering, otherwise no top level domain will show up in Topache, simply because this was not recorded by Apache in its logs.

Statistics

Topache displays statistics for both all resources in a domain/subdomain, as well as statistics for individual resources located on said domain.

If the domain/resource did not receive a request at all, then it does not appear within Topache.

Topaches reports the following statistics:

Statistic Description
R/60s requests per second, averaged over the last 60 seconds
R/300s requests per second, averaged over the last 5 minutes
R/900s requests per second, averaged over the last 15 minutes
TR1M total requests received over the last minute
TR5M total requests received over the last 5 minutes
TR15M total requests received over the last 15 minutes
TR total requests received since start of topache
TTX total transmitted bytes since start of topache

Issues, PRs, etc.

Comments, suggestions and PRs are always welcome.

About

An apache monitoring tool, ala top.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published