Mercurial > prosody-modules
view mod_push2/README.markdown @ 5787:e79f9dec35c0
mod_c2s_conn_throttle: Reduce log level from error->info
Our general policy is that "error" should never be triggerable by remote
entities, and that it is always about something that requires admin
intervention. This satisfies neither condition.
The "warn" level can be used for unexpected events/behaviour triggered by
remote entities, and this could qualify. However I don't think failed auth
attempts are unexpected enough.
I selected "info" because it is what is also used for other notable session
lifecycle events.
| author | Matthew Wild <mwild1@gmail.com> |
|---|---|
| date | Thu, 07 Dec 2023 15:46:50 +0000 |
| parents | 4b052598e435 |
| children |
line wrap: on
line source
--- labels: - Stage-Alpha summary: 'Push 2.0' --- The way forward for push notifications? You are probably looking for `mod_cloud_notify` for now though See also https://hg.prosody.im/prosody-modules/file/tip/mod_push2/push2.markdown Configuration ============= Option Default Description ------------------------------------ ----------------- ------------------------------------------------------------------------------------------------------------------- `contact_uri` xmpp:server.tld Contact information for the server operator (usually as a `mailto:` URI is preferred) `push_max_hibernation_timeout` `259200` (72h) Number of seconds to extend the smacks timeout if no push was triggered yet (default: 72 hours) Internal design notes ===================== App servers are notified about offline messages, messages stored by [mod_mam] or messages waiting in the smacks queue. To cooperate with [mod_smacks] this module consumes some events: `smacks-ack-delayed`, `smacks-hibernation-start` and `smacks-hibernation-end`. These events allow this module to send out notifications for messages received while the session is hibernated by [mod_smacks] or even when smacks acknowledgements for messages are delayed by a certain amount of seconds configurable with the [mod_smacks] setting `smacks_max_ack_delay`. The `smacks_max_ack_delay` setting allows to send out notifications to clients which aren't already in smacks hibernation state (because the read timeout or connection close didn't already happen) but also aren't responding to acknowledgement request in a timely manner. This setting thus allows conversations to be smoother under such circumstances. Compatibility ============= **Note:** This module should be used with Lua 5.3 and higher. Requires a slightly patches luaossl right now: https://github.com/wahern/luaossl/pull/214 ------ ----------------------------------------------------------------------------- trunk Works ------ -----------------------------------------------------------------------------