# bombinisecurity/bombini architecture

> Architecture diagram of the GitHub repository bombinisecurity/bombini, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bombinisecurity/bombini
- Repository: https://github.com/bombinisecurity/bombini

## Overview

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: [`bombini/src/main.rs`](https://github.com/bombinisecurity/bombini/blob/main/bombini/src/main.rs) (Agent entry point), [`bombini-common/src/event.rs`](https://github.com/bombinisecurity/bombini/blob/main/bombini-common/src/event.rs) (Generic event schema), [`bombini/src/monitor.rs`](https://github.com/bombinisecurity/bombini/blob/main/bombini/src/monitor.rs) (Event monitor), [`bombini/src/transmitter`](https://github.com/bombinisecurity/bombini/tree/main/bombini/src/transmitter) (Event transmitters)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Agent control"]
  node_main["Agent entry point<br/>[main.rs]"]
  node_options["Runtime options<br/>[options.rs]"]
  node_config["Configuration<br/>[config.rs]"]
  node_registry["Detector registry<br/>[registry.rs]"]
  node_monitor["Event monitor<br/>[monitor.rs]"]
end

subgraph group_rules["Rule processing"]
  node_rule_parser["Rule parser"]
  node_rule_ast["Rule AST<br/>[ast.rs]"]
  node_serializer["Rule serializer<br/>[serializer.rs]"]
  node_rule_schema["BPF rule schema<br/>[rule.rs]"]
end

subgraph group_sensors["Event detectors"]
  node_detector_api["Detector interface<br/>[detector.rs]"]
  node_user_detectors["User-space detectors"]
  node_ebpf_programs["eBPF detector programs"]
  node_bpf_support["eBPF support"]
end

subgraph group_events["Events and enrichment"]
  node_event_schema["Generic event schema<br/>[event.rs]"]
  node_process_events["Process events<br/>[process.rs]"]
  node_file_events["File events<br/>[file.rs]"]
  node_network_events["Network events<br/>[network.rs]"]
  node_kernel_events["Kernel events<br/>[kernel.rs]"]
  node_transmuters["Event transmuters"]
  node_process_transmuter["Process transmuter<br/>[process.rs]"]
  node_k8s["Kubernetes watcher<br/>[watcher.rs]"]
  node_k8s_metadata["Pod metadata<br/>[podinfo.rs]"]
end

subgraph group_outputs["Outputs and metrics"]
  node_transmitter["Event transmitters"]
  node_stdout["Stdout transmitter<br/>[stdout.rs]"]
  node_event_file["File transmitter<br/>[file.rs]"]
  node_unix_socket["Unix socket transmitter<br/>[unix_sock.rs]"]
  node_metrics["Metrics server<br/>[metrics.rs]"]
end

node_operator(("Operator"))
node_linux["Linux kernel"]

node_operator -->|"starts agent"| node_main
node_linux -.->|"provides hook events"| node_ebpf_programs
node_main -->|"parses options"| node_options
node_main -->|"loads configuration"| node_config
node_operator -->|"supplies settings"| node_config
node_main -->|"loads detectors"| node_registry
node_registry -.->|"loads implementations"| node_detector_api
node_detector_api -->|"implemented by"| node_user_detectors
node_user_detectors -.->|"loads eBPF programs"| node_ebpf_programs
node_ebpf_programs -.->|"uses shared support"| node_bpf_support
node_config -.->|"provides rule text"| node_rule_parser
node_rule_parser -.->|"builds expressions"| node_rule_ast
node_serializer -->|"parses predicates"| node_rule_parser
node_serializer -->|"serializes expressions"| node_rule_ast
node_serializer -->|"produces BPF rules"| node_rule_schema
node_user_detectors -.->|"serializes detector rules"| node_serializer
node_main -->|"starts monitoring"| node_monitor
node_monitor -.->|"processes events"| node_event_schema
node_ebpf_programs -.->|"emits event records"| node_event_schema
node_event_schema -->|"defines process variant"| node_process_events
node_event_schema -->|"defines file variant"| node_file_events
node_event_schema -->|"defines network variant"| node_network_events
node_event_schema -->|"defines kernel variant"| node_kernel_events
node_monitor -.->|"transforms events"| node_transmuters
node_transmuters -->|"includes process handler"| node_process_transmuter
node_process_transmuter -->|"reads process data"| node_process_events
node_main -->|"starts watcher"| node_k8s
node_k8s -.->|"provides pod metadata"| node_k8s_metadata
node_process_transmuter -.->|"enriches process events"| node_k8s_metadata
node_main -->|"starts metrics server"| node_metrics
node_main -->|"selects default output"| node_stdout
node_main -->|"selects file output"| node_event_file
node_monitor -.->|"sends monitored events"| node_transmitter
node_transmitter -->|"includes stdout output"| node_stdout
node_transmitter -->|"includes file output"| node_event_file
node_transmitter -->|"includes socket output"| node_unix_socket

click node_main "https://github.com/bombinisecurity/bombini/blob/main/bombini/src/main.rs"
click node_options "https://github.com/bombinisecurity/bombini/blob/main/bombini/src/options.rs"
click node_config "https://github.com/bombinisecurity/bombini/blob/main/bombini/src/config.rs"
click node_registry "https://github.com/bombinisecurity/bombini/blob/main/bombini/src/registry.rs"
click node_monitor "https://github.com/bombinisecurity/bombini/blob/main/bombini/src/monitor.rs"
click node_rule_parser "https://github.com/bombinisecurity/bombini/blob/main/bombini/src/rule/predicate_parser.rs"
click node_rule_ast "https://github.com/bombinisecurity/bombini/blob/main/bombini/src/rule/ast.rs"
click node_serializer "https://github.com/bombinisecurity/bombini/blob/main/bombini/src/rule/serializer.rs"
click node_rule_schema "https://github.com/bombinisecurity/bombini/blob/main/bombini-common/src/config/rule.rs"
click node_detector_api "https://github.com/bombinisecurity/bombini/blob/main/bombini/src/detector.rs"
click node_user_detectors "https://github.com/bombinisecurity/bombini/tree/main/bombini/src/detector"
click node_ebpf_programs "https://github.com/bombinisecurity/bombini/tree/main/bombini-detectors-ebpf/src/bin"
click node_bpf_support "https://github.com/bombinisecurity/bombini/tree/main/bombini-detectors-ebpf/src"
click node_event_schema "https://github.com/bombinisecurity/bombini/blob/main/bombini-common/src/event.rs"
click node_process_events "https://github.com/bombinisecurity/bombini/blob/main/bombini-common/src/event/process.rs"
click node_file_events "https://github.com/bombinisecurity/bombini/blob/main/bombini-common/src/event/file.rs"
click node_network_events "https://github.com/bombinisecurity/bombini/blob/main/bombini-common/src/event/network.rs"
click node_kernel_events "https://github.com/bombinisecurity/bombini/blob/main/bombini-common/src/event/kernel.rs"
click node_transmuters "https://github.com/bombinisecurity/bombini/tree/main/bombini/src/transmuter"
click node_process_transmuter "https://github.com/bombinisecurity/bombini/blob/main/bombini/src/transmuter/process.rs"
click node_k8s "https://github.com/bombinisecurity/bombini/blob/main/bombini/src/k8s/watcher.rs"
click node_k8s_metadata "https://github.com/bombinisecurity/bombini/blob/main/bombini/src/k8s/podinfo.rs"
click node_transmitter "https://github.com/bombinisecurity/bombini/tree/main/bombini/src/transmitter"
click node_stdout "https://github.com/bombinisecurity/bombini/blob/main/bombini/src/transmitter/stdout.rs"
click node_event_file "https://github.com/bombinisecurity/bombini/blob/main/bombini/src/transmitter/file.rs"
click node_unix_socket "https://github.com/bombinisecurity/bombini/blob/main/bombini/src/transmitter/unix_sock.rs"
click node_metrics "https://github.com/bombinisecurity/bombini/blob/main/bombini/src/metrics.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_options,node_config,node_registry,node_monitor toneBlue
class node_rule_parser,node_rule_ast,node_serializer,node_rule_schema toneAmber
class node_detector_api,node_user_detectors,node_ebpf_programs,node_bpf_support toneMint
class node_event_schema,node_process_events,node_file_events,node_network_events,node_kernel_events,node_transmuters,node_process_transmuter,node_k8s,node_k8s_metadata toneRose
class node_transmitter,node_stdout,node_event_file,node_unix_socket,node_metrics,node_operator,node_linux toneIndigo
```

## Components

### Agent control

- [Agent entry point](https://github.com/bombinisecurity/bombini/blob/main/bombini/src/main.rs): `bombini/src/main.rs`
- [Runtime options](https://github.com/bombinisecurity/bombini/blob/main/bombini/src/options.rs): `bombini/src/options.rs`
- [Configuration](https://github.com/bombinisecurity/bombini/blob/main/bombini/src/config.rs): `bombini/src/config.rs`
- [Detector registry](https://github.com/bombinisecurity/bombini/blob/main/bombini/src/registry.rs): `bombini/src/registry.rs`
- [Event monitor](https://github.com/bombinisecurity/bombini/blob/main/bombini/src/monitor.rs): `bombini/src/monitor.rs`

### Rule processing

- [Rule parser](https://github.com/bombinisecurity/bombini/blob/main/bombini/src/rule/predicate_parser.rs): `bombini/src/rule/predicate_parser.rs`
- [Rule AST](https://github.com/bombinisecurity/bombini/blob/main/bombini/src/rule/ast.rs): `bombini/src/rule/ast.rs`
- [Rule serializer](https://github.com/bombinisecurity/bombini/blob/main/bombini/src/rule/serializer.rs): `bombini/src/rule/serializer.rs`
- [BPF rule schema](https://github.com/bombinisecurity/bombini/blob/main/bombini-common/src/config/rule.rs): `bombini-common/src/config/rule.rs`

### Event detectors

- [Detector interface](https://github.com/bombinisecurity/bombini/blob/main/bombini/src/detector.rs): `bombini/src/detector.rs`
- [User-space detectors](https://github.com/bombinisecurity/bombini/tree/main/bombini/src/detector): `bombini/src/detector`
- [eBPF detector programs](https://github.com/bombinisecurity/bombini/tree/main/bombini-detectors-ebpf/src/bin): `bombini-detectors-ebpf/src/bin`
- [eBPF support](https://github.com/bombinisecurity/bombini/tree/main/bombini-detectors-ebpf/src): `bombini-detectors-ebpf/src`

### Events and enrichment

- [Generic event schema](https://github.com/bombinisecurity/bombini/blob/main/bombini-common/src/event.rs): `bombini-common/src/event.rs`
- [Process events](https://github.com/bombinisecurity/bombini/blob/main/bombini-common/src/event/process.rs): `bombini-common/src/event/process.rs`
- [File events](https://github.com/bombinisecurity/bombini/blob/main/bombini-common/src/event/file.rs): `bombini-common/src/event/file.rs`
- [Network events](https://github.com/bombinisecurity/bombini/blob/main/bombini-common/src/event/network.rs): `bombini-common/src/event/network.rs`
- [Kernel events](https://github.com/bombinisecurity/bombini/blob/main/bombini-common/src/event/kernel.rs): `bombini-common/src/event/kernel.rs`
- [Event transmuters](https://github.com/bombinisecurity/bombini/tree/main/bombini/src/transmuter): `bombini/src/transmuter`
- [Process transmuter](https://github.com/bombinisecurity/bombini/blob/main/bombini/src/transmuter/process.rs): `bombini/src/transmuter/process.rs`
- [Kubernetes watcher](https://github.com/bombinisecurity/bombini/blob/main/bombini/src/k8s/watcher.rs): `bombini/src/k8s/watcher.rs`
- [Pod metadata](https://github.com/bombinisecurity/bombini/blob/main/bombini/src/k8s/podinfo.rs): `bombini/src/k8s/podinfo.rs`

### Outputs and metrics

- [Event transmitters](https://github.com/bombinisecurity/bombini/tree/main/bombini/src/transmitter): `bombini/src/transmitter`
- [Stdout transmitter](https://github.com/bombinisecurity/bombini/blob/main/bombini/src/transmitter/stdout.rs): `bombini/src/transmitter/stdout.rs`
- [File transmitter](https://github.com/bombinisecurity/bombini/blob/main/bombini/src/transmitter/file.rs): `bombini/src/transmitter/file.rs`
- [Unix socket transmitter](https://github.com/bombinisecurity/bombini/blob/main/bombini/src/transmitter/unix_sock.rs): `bombini/src/transmitter/unix_sock.rs`
- [Metrics server](https://github.com/bombinisecurity/bombini/blob/main/bombini/src/metrics.rs): `bombini/src/metrics.rs`

### Other components

- **Operator**
- **Linux kernel**

## Connections

- Operator → Agent entry point: starts agent (evidence: `README.md`)
- Linux kernel → eBPF detector programs: provides hook events (evidence: `README.md`)
- Agent entry point → Runtime options: parses options (evidence: `bombini/src/main.rs`)
- Agent entry point → Configuration: loads configuration (evidence: `bombini/src/main.rs`)
- Operator → Configuration: supplies settings (evidence: `README.md`)
- Agent entry point → Detector registry: loads detectors (evidence: `bombini/src/main.rs`)
- Detector registry → Detector interface: loads implementations
- Detector interface → User-space detectors: implemented by (evidence: `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 (evidence: `bombini/src/rule/serializer.rs`)
- Rule serializer → Rule AST: serializes expressions (evidence: `bombini/src/rule/serializer.rs`)
- Rule serializer → BPF rule schema: produces BPF rules (evidence: `bombini/src/rule/serializer.rs`)
- User-space detectors → Rule serializer: serializes detector rules (evidence: `bombini/src/detector/procmon.rs`)
- Agent entry point → Event monitor: starts monitoring (evidence: `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 (evidence: `bombini-common/src/event.rs`)
- Generic event schema → File events: defines file variant (evidence: `bombini-common/src/event.rs`)
- Generic event schema → Network events: defines network variant (evidence: `bombini-common/src/event.rs`)
- Generic event schema → Kernel events: defines kernel variant (evidence: `bombini-common/src/event.rs`)
- Event monitor → Event transmuters: transforms events
- Event transmuters → Process transmuter: includes process handler (evidence: `bombini/src/transmuter/process.rs`)
- Process transmuter → Process events: reads process data (evidence: `bombini/src/transmuter/process.rs`)
- Agent entry point → Kubernetes watcher: starts watcher (evidence: `bombini/src/main.rs`)
- Kubernetes watcher → Pod metadata: provides pod metadata
- Process transmuter → Pod metadata: enriches process events (evidence: `bombini/src/transmuter/process.rs`)
- Agent entry point → Metrics server: starts metrics server (evidence: `bombini/src/main.rs`)
- Agent entry point → Stdout transmitter: selects default output (evidence: `bombini/src/main.rs`)
- Agent entry point → File transmitter: selects file output (evidence: `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
