How bombinisecurity/bombini works
Bombini is a Rust eBPF security-monitoring and sandboxing agent. Its principal workflow is to load configuration and rules, activate event-specific detectors, monitor and transform kernel events, then transmit them (stdout JSON by default). The graph also includes Kubernetes metadata enrichment and metrics. Some detector and event-processing connections are documented or implied but their implementation was not sampled; those links are marked unverified rather than presented as observed calls.
Main entry points: main.rs Agent entry point · event.rs Generic event schema · monitor.rs Event monitor · transmitter Event transmitters
Components 29
Agent control
- Agent entry point
bombini/src/main.rs - Runtime options
bombini/src/options.rs - Configuration
bombini/src/config.rs - Detector registry
bombini/src/registry.rs - Event monitor
bombini/src/monitor.rs
Rule processing
- Rule parser
bombini/src/rule/predicate_parser.rs - Rule AST
bombini/src/rule/ast.rs - Rule serializer
bombini/src/rule/serializer.rs - BPF rule schema
bombini-common/src/config/rule.rs
Event detectors
- Detector interface
bombini/src/detector.rs - User-space detectors
bombini/src/detector - eBPF detector programs
bombini-detectors-ebpf/src/bin - eBPF support
bombini-detectors-ebpf/src
Events and enrichment
- Generic event schema
bombini-common/src/event.rs - Process events
bombini-common/src/event/process.rs - File events
bombini-common/src/event/file.rs - Network events
bombini-common/src/event/network.rs - Kernel events
bombini-common/src/event/kernel.rs - Event transmuters
bombini/src/transmuter - Process transmuter
bombini/src/transmuter/process.rs - Kubernetes watcher
bombini/src/k8s/watcher.rs - Pod metadata
bombini/src/k8s/podinfo.rs
Outputs and metrics
- Event transmitters
bombini/src/transmitter - Stdout transmitter
bombini/src/transmitter/stdout.rs - File transmitter
bombini/src/transmitter/file.rs - Unix socket transmitter
bombini/src/transmitter/unix_sock.rs - Metrics server
bombini/src/metrics.rs
Other components
- Operator
- Linux kernel
Connections 36
- Operator → Agent entry point: starts agent
README.md - Linux kernel → eBPF detector programs: provides hook events
README.md - Agent entry point → Runtime options: parses options
bombini/src/main.rs - Agent entry point → Configuration: loads configuration
bombini/src/main.rs - Operator → Configuration: supplies settings
README.md - Agent entry point → Detector registry: loads detectors
bombini/src/main.rs - Detector registry → Detector interface: loads implementations
- Detector interface → User-space detectors: implemented by
bombini/src/detector.rs - User-space detectors → eBPF detector programs: loads eBPF programs
- eBPF detector programs → eBPF support: uses shared support
- Configuration → Rule parser: provides rule text
- Rule parser → Rule AST: builds expressions
- Rule serializer → Rule parser: parses predicates
bombini/src/rule/serializer.rs - Rule serializer → Rule AST: serializes expressions
bombini/src/rule/serializer.rs - Rule serializer → BPF rule schema: produces BPF rules
bombini/src/rule/serializer.rs - User-space detectors → Rule serializer: serializes detector rules
bombini/src/detector/procmon.rs - Agent entry point → Event monitor: starts monitoring
bombini/src/main.rs - Event monitor → Generic event schema: processes events
- eBPF detector programs → Generic event schema: emits event records
- Generic event schema → Process events: defines process variant
bombini-common/src/event.rs - Generic event schema → File events: defines file variant
bombini-common/src/event.rs - Generic event schema → Network events: defines network variant
bombini-common/src/event.rs - Generic event schema → Kernel events: defines kernel variant
bombini-common/src/event.rs - Event monitor → Event transmuters: transforms events
- Event transmuters → Process transmuter: includes process handler
bombini/src/transmuter/process.rs - Process transmuter → Process events: reads process data
bombini/src/transmuter/process.rs - Agent entry point → Kubernetes watcher: starts watcher
bombini/src/main.rs - Kubernetes watcher → Pod metadata: provides pod metadata
- Process transmuter → Pod metadata: enriches process events
bombini/src/transmuter/process.rs - Agent entry point → Metrics server: starts metrics server
bombini/src/main.rs - Agent entry point → Stdout transmitter: selects default output
bombini/src/main.rs - Agent entry point → File transmitter: selects file output
bombini/src/main.rs - Event monitor → Event transmitters: sends monitored events
- Event transmitters → Stdout transmitter: includes stdout output
- Event transmitters → File transmitter: includes file output
- Event transmitters → Unix socket transmitter: includes socket output