| server-status |
| ============= |
| |
| `mod_lua` version of the Apache httpd's mod_status using dynamic charts |
| |
| ## What does it do? ## |
| This script is an extended version of the known mod_status statistics page for httpd. |
| It uses the simple Quokka Chart API to visualize many of the elements that are sometimes hard |
| to properly diagnose using plain text information. |
| |
| Take a look at https://www.apache.org/server-status to see how it works. |
| |
| ## Requirements ## |
| * Apache httpd 2.4.6 or higher |
| * mod_lua (with either Lua 5.1, 5.2 or LuaJIT) |
| * mod_status loaded (for enabling traffic statistics) |
| |
| ## Installing ## |
| First, install mod_lua (you can enable this during configure time with --enable-lua) |
| |
| ### Installing as a handler: |
| To install it as a handler, add the following to your httpd.conf in the appropriate VirtualHost: |
| |
| LuaMapHandler ^/server-status$ /path/to/server-status.lua |
| |
| ### Installing as a web app: |
| To install as a plain web-app, enable .lua scripts to be handled by mod_lua, by adding the following |
| to your appropriate VirtualHost configuration: |
| |
| AddHandler lua-script .lua |
| |
| Then just put the `.lua` script somewhere in your document root and visit the page. |
| |
| ## Configuring |
| There are a few options inside the Lua script that can be set to `true` or `false`: |
| |
| - `show_warning`: Whether or not to show a notice that this page is there on purpose. |
| - `redact_ips`: Whether or not to replace the last few bits of every IP with 'x.x' |
| - `show_modules`: Whether to show the list of loaded modules or not |
| - `show_threads`: Whether to show thread details or not. |
