42 lines
1.1 KiB
Markdown
42 lines
1.1 KiB
Markdown
|
mod_message_log - Log one line per message transmission
|
||
|
|
=======================================================
|
||
|
|
|
||
|
|
* Author: Holger Weiss <holger@zedat.fu-berlin.de>
|
||
|
|
|
||
|
|
|
||
|
|
Description
|
||
|
|
-----------
|
||
|
|
|
||
|
|
This module writes a line for each sent or received message to a log file.
|
||
|
|
Each line mentions the sender's JID and the recipient's JID, and also the
|
||
|
|
message type (e.g., `"normal"`, `"chat"`, or `"groupchat"`). Carbon copies are
|
||
|
|
marked as such. The log lines look similar to this one:
|
||
|
|
|
||
|
|
```
|
||
|
|
2014-05-25 11:55:04 [outgoing, normal] dan@example.com/Foo -> eve@example.net/Bar
|
||
|
|
```
|
||
|
|
|
||
|
|
After log rotation, you can execute the following command in order to tell
|
||
|
|
`mod_message_log` to reopen the log file:
|
||
|
|
|
||
|
|
```
|
||
|
|
ejabberdctl reopen_log
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
Configuration
|
||
|
|
-------------
|
||
|
|
|
||
|
|
In order to use this module, add the following lines to the modules section
|
||
|
|
of your ejabberd.yml file:
|
||
|
|
|
||
|
|
```
|
||
|
|
modules:
|
||
|
|
mod_message_log:
|
||
|
|
filename: "/path/to/ejabberd-message.log"
|
||
|
|
```
|
||
|
|
|
||
|
|
If the filename option is set to `auto`, it will be set to
|
||
|
|
the default ejabberd log path, with the file name `"message.log"`.
|
||
|
|
The filename option takes as default value `auto`.
|