prosody-modules: mod_log_events_by_memory/README.markdown annotate

annotate mod_log_events_by_memory/README.markdown @ 5038:88980b2dd986

mod_sasl2: Hacky support for channel binding We should work out how to share this code properly between here and mod_saslauth.

author	Matthew Wild <mwild1@gmail.com>
date	Tue, 06 Sep 2022 16:01:12 +0100
parents	f781a90018f4
children

rev	line source
3615 5fe34e5f9829 mod_log_events_by_memory: Log events where Lua memory usage increased Kim Alvefur <zash@zash.se> parents: diff changeset	1 This module compares the memory usage reported by Lua before and after
5fe34e5f9829 mod_log_events_by_memory: Log events where Lua memory usage increased Kim Alvefur <zash@zash.se> parents: diff changeset	2 each event and reports it to the log if it exceeds the configuration
5fe34e5f9829 mod_log_events_by_memory: Log events where Lua memory usage increased Kim Alvefur <zash@zash.se> parents: diff changeset	3 setting `log_memory_threshold` (in bytes).
5fe34e5f9829 mod_log_events_by_memory: Log events where Lua memory usage increased Kim Alvefur <zash@zash.se> parents: diff changeset	4
5fe34e5f9829 mod_log_events_by_memory: Log events where Lua memory usage increased Kim Alvefur <zash@zash.se> parents: diff changeset	5 ``` lua
5fe34e5f9829 mod_log_events_by_memory: Log events where Lua memory usage increased Kim Alvefur <zash@zash.se> parents: diff changeset	6 log_memory_threshold = 20*1024
5fe34e5f9829 mod_log_events_by_memory: Log events where Lua memory usage increased Kim Alvefur <zash@zash.se> parents: diff changeset	7 ```
5fe34e5f9829 mod_log_events_by_memory: Log events where Lua memory usage increased Kim Alvefur <zash@zash.se> parents: diff changeset	8
3618 f781a90018f4 mod_log_events_by_memory: Add link to post explaining different kinds of memory leaks Kim Alvefur <zash@zash.se> parents: 3617 diff changeset	9 If you are looking to identify memory leaks, please first read [Three
f781a90018f4 mod_log_events_by_memory: Add link to post explaining different kinds of memory leaks Kim Alvefur <zash@zash.se> parents: 3617 diff changeset	10 kinds of memory
f781a90018f4 mod_log_events_by_memory: Add link to post explaining different kinds of memory leaks Kim Alvefur <zash@zash.se> parents: 3617 diff changeset	11 leaks](https://blog.nelhage.com/post/three-kinds-of-leaks/).
f781a90018f4 mod_log_events_by_memory: Add link to post explaining different kinds of memory leaks Kim Alvefur <zash@zash.se> parents: 3617 diff changeset	12
3617 61b9c89db212 mod_log_events_by_memory: Add a rant to README about uselessness of this module Kim Alvefur <zash@zash.se> parents: 3615 diff changeset	13 Prosody runs on Lua which uses automatic memory management with garbage
61b9c89db212 mod_log_events_by_memory: Add a rant to README about uselessness of this module Kim Alvefur <zash@zash.se> parents: 3615 diff changeset	14 collection, so the numbers reported by this module are very likely to be
61b9c89db212 mod_log_events_by_memory: Add a rant to README about uselessness of this module Kim Alvefur <zash@zash.se> parents: 3615 diff changeset	15 useless for the purpose of identifying memory leaks. Large, but
61b9c89db212 mod_log_events_by_memory: Add a rant to README about uselessness of this module Kim Alvefur <zash@zash.se> parents: 3615 diff changeset	16 temporary, increases in memory usage can however highlight other kinds
61b9c89db212 mod_log_events_by_memory: Add a rant to README about uselessness of this module Kim Alvefur <zash@zash.se> parents: 3615 diff changeset	17 of performance problems and sometimes even provide hits for where to
61b9c89db212 mod_log_events_by_memory: Add a rant to README about uselessness of this module Kim Alvefur <zash@zash.se> parents: 3615 diff changeset	18 look for memory leaks.