comparison mod_muclogging.wiki @ 55:4604930cc085

mod_muclogging initial wiki
author t.ephraim
date Fri, 16 Oct 2009 21:46:37 +0000
parents
children 1dd6406d8fab
comparison
equal deleted inserted replaced
54:3530fa4b114c 55:4604930cc085
1 #summary Module which logs muc conversations to a file
2 #labels Stage-Alpha
3
4 = Introduction =
5
6 This module logs the conversation of muc running on this server to a daily changing file.
7 There is a file per room.
8
9 = Details =
10
11 To enable it, you will need to configure a logFolder at the muc component, which should log.
12 e.g.
13 {{{
14 Component "rooms.example.com" "muc"
15 logFolder = "/var/log/prosody/rooms"
16 }}}
17
18 In this folder will then created files in form of YearMonthDay_RoomJid.log
19 e.g.:
20 {{{
21 091015_foobar@rooms.example.com.log
22 }}}
23
24 The content of the logfile are the presence and message stanza's which depend to this room.
25 They are wrapped around by a <stanza> tag with an additional time attribute.
26 That should make it possible to create nice output in every way.
27 e.g.:
28 {{{
29 <stanza time="23:41:14"><message type='groupchat' from='foobar@rooms.example.com/ephraim' id='aae4a' xmlns='jabber:client'>
30 <body>test</body>
31 <nick xmlns='http://jabber.org/protocol/nick'>Ephraim</nick>
32 </message></stanza>
33 }}}
34
35 = TODO =
36 * create a simple php script to format the log so the output is more human readable