How sipcapture/helm-charts works
Project type and purpose
• This repository is a Helm chart packaging for “sipcapture”—a Kubernetes-native deployment of a SIP capture and analytics stack.
• It defines all the Kubernetes resources (StatefulSets, Services, ConfigMaps, Ingress, etc.) needed to deploy the Heplify SIP collector, time-series database, analytics agents, dashboards, and a web UI.
File structure
• Top-level:
• .github/workflows/helm.yml (CI/CD publishing the chart)
• LICENSE, README.md
• charts/sipcapture/
• charts/sipcapture/:
• Chart.yaml, values.yaml (chart metadata & default values)
• configs/: static dashboard JSON and datasource definitions for Grafana
• templates/: Kubernetes manifest templates for each component
– heplify-server (SIP capture)
– influxdb (time-series storage)
– postgres (relational metadata)
– telegraf (metrics collector)
– grafana (dashboards)
– webapp (user interface)
– namespace, ingress, helper functions, NOTES
README for additional insights
• The chart is published at a public Helm repo and contributed by the Jambonz project.
Main components and interactions to capture
a. External SIP traffic → Heplify Server (StatefulSet)
b. Heplify writes call records/metrics to:
• InfluxDB (StatefulSet + Service)
• Postgres (StatefulSet + Service)
c. Telegraf (StatefulSet + Service) scrapes metrics from InfluxDB and the Heplify server, then forwards them back into InfluxDB for enriched telemetry.
d. Grafana (StatefulSet + Service) reads from InfluxDB using configured datasources and displays dashboards (configured via ConfigMaps).
e. Webapp (Deployment + Service + Ingress) provides a user interface that reads aggregated data from Postgres and/or InfluxDB.
Architectural patterns and design principles
• Micro-services pattern: each functional component runs in its own StatefulSet/Deployment.
• Config-as-Code: dashboards and datasources are managed via Helm ConfigMaps.
• Stateful workloads: InfluxDB & Postgres use StatefulSets for persistent storage.
• Declarative infrastructure: everything is templated in Helm for repeatable deployments.