Module Description
This module implements an offline messages storage compliant with XEP-0160: Best Practices for Handling Offline Messages.
It stores one-to-one messages only when the recipient has no online resources.
It is not well suited for applications supporting multiple user devices, because anything saved in the DB can be retrieved only once, so the message history is not synchronised between devices.
Although mod_offline
may be sufficient in some cases, it is preferable to use mod_mam.
Options
access_max_user_messages
(atom, default:max_user_offline_messages
): Access Rule to use for limiting the storage size per user.backend
(atom, default:mnesia
): Storage backend. Currentlymnesia
,rdbms
andriak
are supported.
Example Configuration
{mod_offline, [{access_max_user_messages, max_user_offline_messages}]},
Metrics
If you'd like to learn more about metrics in MongooseIM, please visit MongooseIM metrics page.
Name | Type | Description (when it gets incremented) |
---|---|---|
[global, backends, mod_offline, pop_messages] |
histogram | Time it takes to fetch and delete offline messages for a user in a DB. |
[global, backends, mod_offline, write_messages] |
histogram | Time it takes to write new offline messages to a user in a DB. |