More information in docs is always good. Hopefully @gbour will add more there.

To answer quickly some of your questions based on my review:

* it is SIP-based monitoring (keepalive pinging with OPTIONS, like dispatcher does) * PR #1066 enhanced drouting to use keepalive module for monitoring its gateways

Hi @agranig, @kamailio-sync @ First, the module is still young, so the documentation may be incomplete. I will improve it asap

Second, my primary idea when started this module was to implement the same "destinations probing" mechanism found in dispatcher module, both in drouting & carrierroute modules. So instead of directly patching those modules (and duplicating the same code), I regroup all probing features in *keepalive* module that also expose a set of APIs (to be documented) to register a destination and be notified of destination status change. Following @miconda suggestions, it can also be used standalone

_What does that mean?_ So currently you can use it in 2 ways: - standalone: destinations to monitor are statically defined as module parameter then you can use is_alive() function or event route to react to destination state change - as "probing engine" for drouting module: by setting _enable_keepalive_ drouting parameter, drouting destinations will be monitored by keepalive, and a call to do_routing() will ignore inactive destinations in the resultset. I will add examples to the documentation to make things clear, but you can already see a kamailio.cfg example for both case in this ml post: https://lists.kamailio.org/pipermail/sr-users/2017-March/096521.html

_What are the use cases and which problems does it solve?_ - monitor remote trunks (allowing to take actions or trigger an alert when a destination is down) - ignore down destinations when routing a call

_Which mechanisms does it use (SIP, ICMP, others?)_ It is working the same way as dispatcher does, by regularly sending SIP OPTIONS to destinations

Hope I answered all your questions

I added some notes about the monitoring type in the readme, improvements are welcome. Closing this one.