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 export
- Local (Source) Port - some unused local UDP and TCP port, export would be performed from this port on any IP assigned to an Environment, e.g. 9192
- Collector - parameters of remote system where to send the logs to. E.g. 1.2.3.4:9060; version=2; transport=udp
- only UDP transport is supported as of 2023 version (25.11.2024)
- 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, this configuration is not supported in >=2023
- No version provided - configuration defaults to specified transport, version=3
- No version nor transport are provided - configuration defaults to version=3 and transport=tcp, this configuration is not supported in >=2023
- transport=tcp works only with version=3, setting any other version would cause export to be done via UDP