lmangani / heplify-server Goto Github PK

heplify-server is a stand-alone HOMER Capture Server developed in Go, optimized for speed and simplicity. Distributed as a single binary ready to capture TCP/TLS/UDP HEP encapsulated packets from heplify or any other HEP enabled agent or platform, indexing to database using H5 or H7 table format, producing basic usage metrics timeseries and providing users with simple, basic options for correlation and tagging inline.

TLDR; instant, stand-alone, minimal HOMER without Kamailio or OpenSIPS dependency/options.

heplify-server offers a reduced set of options and is not designed for everyone, but should result ideal for those willing to have an all-in-one simple capture deployment with minimal complexity and no need for special customization.

• Release Candidate Stage
  • SIP, correlated RTCP, RTCPXR, Logs, Table rotation

• Alpha Stage
  • Table rotation

• Release Candidate Stage
  • Global and device specific stats for SIP methods, responses, RTCP, RTCPXR, X-RTP-Stat
  • SIP KPI's like ASR, NER can be calculated by Prometheus

• Download a release
• Compile from sources
• Testers, Reporters and Contributors welcome

heplify-server can be configured using command-line options, or by defining a local configuration file

heplify-server -h

A sample Docker compose file is available providing Heplify-Server, Homer 5 UI, and basic MySQL in seconds!

cd heplify-server/docker/homer-heplify
docker-compose up -d

A sample service file is available under /example

cp example/heplify-server.service /etc/systemd/system/
systemctl daemon-reload
systemctl start heplify-server
systemctl enable heplify-server

This Open-Source project is made possible by actual Humans without corporate sponsors, angels or patreons.
If you use this software in production, please consider supporting its development with contributions or donations