diff mod_server_status.wiki @ 255:3bd927d2ac33

renamed mod_xml_status to mod_server_status, changing wiki to reflect that.
author Marco Cirillo <maranda@lightwitch.org>
date Tue, 10 Jan 2012 19:43:51 +0000
parents mod_xml_status.wiki@97f27542295a
children c44f0864b33c
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_server_status.wiki	Tue Jan 10 19:43:51 2012 +0000
@@ -0,0 +1,26 @@
+#summary Server status plugin
+#labels Stage-Beta
+
+= Introduction =
+
+This module fetches the current status of configured hosts and/or stanza statistics from [http://code.google.com/p/prosody-modules/wiki/mod_stanza_counter# mod_stanza_counter].
+And outputs it in either XML or JSON format.
+
+= Usage =
+
+Copy the file into prosody's module directory and place it into your global's enabled modules.
+
+Configuration example:
+{{{
+server_status_http_ports = {{ port = 5280, path = "mystatsbasepath" }}
+server_status_show_hosts = { "iwanttoshowifthishostisonline.com", "iwanttoshowifthishostisonline2.com" }
+server_status_show_comps = { "muc.iwanttoshowifthishostisonline.com", "transport.iwanttoshowifthishostisonline.com" }
+server_status_json = true
+}}}
+
+By default the plugin's output is in XML, setting server_status_json to "true" will turn it into JSON instead.
+if mod_stanza_counter isn't loaded the plugin will require at least either server_status_show_hosts or server_status_show_comps to be set.
+
+= Compatibility =
+
+ * 0.8+ Works.