view mod_host_status_check/README.markdown @ 4525:b68b801ddc50

mod_rest: Restore 'kind' property in JSON-mapped objects The datamapper schema has no 'kind' field, instead handling it as a top-level property of the currently unused <xmpp> element and doing this early dispatch on the top level element name. This puts the field back into the output JSON.
author Kim Alvefur <zash@zash.se>
date Tue, 23 Mar 2021 17:44:49 +0100
parents 2a16a6c67288
children 694b62d8a82f
line wrap: on
line source

---
labels: Stage-Beta
summary: Host status check
...

Introduction
============

This module allows you to monitor the state of hosts and components in your Prosody server. For example,
it will track whether components are connected and (if the component supports it) listen for heartbeats
sent by the component to indicate that it is functioning.

This module does not expose any interface to access the status information itself. See [mod\_http\_host\_status\_check]
for a module that allows you to access host status information over HTTP(S).

Configuration
=============

There are no configuration options for this module.

You should enable it on every host that you want to monitor, by adding it to modules\_enabled. Note
that to monitor components, adding to the global modules\_enabled list will not suffice - you will
need to add it to the component's own modules\_enabled, like this:

``` {.lua}
Component "mycomponent.example.com"
   modules_enabled = { "host_status_check" }
```

Compatibility
=============

Works with Prosody 0.9.x and later.