From 5dff2d61cc1c27747ee398e04d8e02843aabb1f8 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Tue, 7 May 2024 04:04:06 +0200 Subject: Adding upstream version 2.4.38. Signed-off-by: Daniel Baumann --- docs/server-status/README.md | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 docs/server-status/README.md (limited to 'docs/server-status/README.md') diff --git a/docs/server-status/README.md b/docs/server-status/README.md new file mode 100644 index 0000000..ddb876d --- /dev/null +++ b/docs/server-status/README.md @@ -0,0 +1,40 @@ +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. -- cgit v1.2.3