Comparison

mod_http_stats_stream/README.md @ 6209:d611ed13df7e draft

Merge
author Trần H. Trung <xmpp:trần.h.trung@trung.fun>
date Tue, 18 Mar 2025 00:16:25 +0700
parent 4595:mod_http_stats_stream/README.markdown@bac3dae031ee
comparison
equal deleted inserted replaced
6208:e20901443eae 6209:d611ed13df7e
1 ---
2 depends:
3 - 'mod\_http'
4 provides:
5 - http
6 ---
7
8 # Introduction
9
10 This module provides a streaming interface to [Prosodys internal statistics][doc:statistics] via
11 [Server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events).
12
13 ## Example
14
15 ```js
16 var evtSource = new EventSource("/stats_stream");
17
18 /*
19 * An event with all current statistics in the form of a JSON object.
20 * Normally sent only once, when first connected to the stream.
21 */
22 evtSource.addEventListener("stats-full", function(e) {
23 var initial_stats = JSON.parse(e.data);
24 console.log(initial_stats);
25 }, false);
26
27 /*
28 * An event containing only statistics that have changed since the last
29 * 'stats-full' or 'stats-updated' event.
30 */
31 evtSource.addEventListener("stats-updated", function(e) {
32 var updated_stats = JSON.parse(e.data);
33 console.log(updated_stats);
34 }, false);
35 ```
36
37 # Compatibility
38
39 * Prosody \>= 0.11.0
40 * Trunk < [5f15ab7c6ae5](https://hg.prosody.im/trunk/rev/5f15ab7c6ae5)