A new functionality on top of OpenSIPS >=3.4 - export of SIP log data to the remote system like Kamalio or Homer for further analysis.
This was made possible with the usage of proto_hep module.
HEP Tracing should be enabled through the web interface at System Management - SIP Features - SIP, Media, LRN, HEP. or via XMLAPI
Below is an example of how to set up HEP parameters:
Parameters description:
- Enable - checked to enable, unchecked to disable export. If disabled, previously saved HEP settings are retained in the database, so you can restore or adjust them later by simply re-enabling HEP.
- Local (Source) Port - port from which SIP logs are sent via HEP. Must be a number in the range 1–65535 and cannot be left empty. Better pick one of the unused ports.
- Collector - hostname/IP address of remote system where to send the logs to. E.g. 1.2.3.4:5060
- Transport - the HEP transport protocol can be UDP or TCP. Since 2024 both are fully supported in OpenSIPS 3.5
- HEP Version - possible values for version are 1,2,3. 2 for UDP and 3 for TCP. If using TCP then version 3 will be automatically set. Other combinations may cause export to fallback to UDP.
Note, change of HEP parameters cause the corresponding OpenSIPS daemons to reload the changes, which may result in a short call processing outage. It's recommended to perform configuration changes in off-peak only.