Starting from 2023 version a new functionality was added 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 only be enabled through the web interface at System Management - SIP Features - SIP, Media, LRN, HEP. This should not be configured through our xmlapi system, since this way will allow for checks to verify you are using the correct version of OpenSIPS prior to making this configuration change.
Setup from Sippy side allows to set three parameters in system_config:
- Enable - true to enable, false to disable feature
- Local (Source) Port - some unused local UDP and TCP port, export would be performed from this port on any IP assigned to an Environment.
- Collector - parameters of remote system where to send the logs to. E.g. 2.2.3.4:9060; transport=tcp; version=3
- possible values for transport are udp and tcp
- possible values for version are 1,2,3
Could be shortened based on the following rules:
- No transport is provided, e.g. 1.2.3.4:9060; version=2 - configuration defaults to transport=udp
- No transport is provided, e.g. 1.2.3.4:9060; version=3 - configuration defaults to transport=tcp
- No version provided - configuration defaults to specified transport, version=3
- No version nor transport are provided - configuration defaults to version=3 and transport=tcp
- transport=tcp works only with version=3, setting any other version would cause export to be done via UDP