3848
|
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 |
|