3844
|
1 This module provides **public** access to Prosodys |
|
2 [internal statistics][doc:statistics] trough the |
|
3 [XEP-0039: Statistics Gathering] protocol. This is a simple protocol |
|
4 that returns triplets of name, unit and value for each know statistic |
|
5 collected by Prosody. The names used are the internal names assigned by |
|
6 modules or statsmanager, names from the registry are **not** used. |
|
7 |
|
8 # Configuration |
|
9 |
|
10 Enabled as usual by adding to [`modules_enabled`][doc:modules_enabled]: |
|
11 |
|
12 ```lua |
|
13 -- Enable Prosodys internal statistics gathering |
|
14 statistics = "internal" |
|
15 |
|
16 -- and enable the module |
|
17 modules_enabled = { |
|
18 -- other modules |
|
19 "stats39"; |
|
20 } |
|
21 ``` |
|
22 |
|
23 # Usage |
|
24 |
|
25 |
|
26 ## Example |
|
27 |
|
28 Statistics can be queried from the XML console of clients that have one: |
|
29 |
|
30 ```xml |
|
31 C: |
|
32 <iq type="get" to="example.com" id="dTMERjt5"> |
|
33 <query xmlns="http://jabber.org/protocol/stats"/> |
|
34 </iq> |
|
35 |
|
36 S: |
|
37 <iq type="result" to="example.com" id="dTMERjt5"> |
|
38 <query xmlns="http://jabber.org/protocol/stats"> |
|
39 </query> |
|
40 </iq> |
|
41 ``` |
|
42 |