Docs Use the optional integrations in contrib

Use the optional integrations in contrib

The starter config, MCP tracing script, observability stack, Grafana dashboard, alert rules and fail2ban files that ship in the repo but not in the packages.

On this page

Optional integrations you can adopt if they suit your deployment. sipnab runs without any of it, and none of it ships inside the .deb, .rpm, or Homebrew formula — packaging/ builds those.

Treat these as starting points to copy and adapt, not as configuration the project keeps in lockstep with your infrastructure.

PathWhat it is
sipnabrc.exampleAnnotated starter config. Parsed by config_wiring_test.rs with the real loader, so every key in it is one sipnab actually reads.
mcp/trace-call.pyFollows one call across several sipnab MCP nodes without an interactive agent. Standard library only. Walked through in the MCP deployment guide.
observability/Docker Compose stack — Prometheus, Grafana, OTel Collector, Tempo — wired to sipnab’s --metrics endpoint (sipnab --metrics 0.0.0.0:9100). Has its own README.
grafana/sipnab-dashboard.jsonSingle importable Grafana dashboard, for an existing Grafana rather than the stack above.
prometheus/sipnab-alerts.ymlExample alerting rules.
fail2ban/Filter and jail configuration that turns sipnab’s scanner-detection output into bans.

Where things live

The split is by who maintains the contract, not by who wrote the file — all of this is first-party:

  • packaging/ — release machinery. Runs on every tag, gated by CI, and a broken path there breaks a published artifact.
  • contrib/ — examples. Nothing here runs unless you choose to run it, and the only automated check is that sipnabrc.example still parses.