Mercurial > prosody-modules
diff mod_audit_status/README.md @ 5650:0eb2d5ea2428
merge
| author | Stephen Paul Weber <singpolyma@singpolyma.net> |
|---|---|
| date | Sat, 06 May 2023 19:40:23 -0500 |
| parents | c450dbf6c0fa |
| children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/mod_audit_status/README.md Sat May 06 19:40:23 2023 -0500 @@ -0,0 +1,29 @@ +--- +summary: Log server status changes to audit log +rockspec: {} +... + +This module records server status (start, stop, crash) to the audit log +maintained by [mod_audit]. + +## Configuration + +There is a single option, `audit_status_heartbeat_interval` which specifies +the interval at which the "server is running" heartbeat should be updated (it +is stored in Prosody's configured storage backend). + +To detect crashes, Prosody periodically updates this value at the specified +interval. A low value will update more frequently, which causes additional I/O +for Prosody. A high value will give less accurate timestamps for "server +crashed" events in the audit log. + +The default value is 60 (seconds). + +```lua +audit_status_heartbeat_interval = 60 +``` + +## Compatibility + +This module requires Prosody trunk (as of April 2023). It is not compatible +with 0.12.
