How cilium/tetragon works
Core Components (Top Level)
a. Tetragon Agent (Central Component):
• As the main controller component
• To both kernel space and user space components
• Observer and sensor management subsystems
b. eBPF Programs Layer:
• Various sensors (process, network, syscall)
• Connection to kernel hooks
• BPF maps for data sharing
c. User Space Components:
• API server (gRPC)
• Policy engine
• Event processing pipeline
• Metrics exporters
a. Kernel Events Flow:
• eBPF programs → BPF maps
• BPF maps → Tetragon Agent
• Agent → Event Processing
• Event Processing → Exporters/API
b. Control Flow:
• Policy Updates → Policy Engine
• Policy Engine → Sensor Management
• Sensor Management → eBPF Program Loading
Integration Points (External Connections)
a. Kubernetes Integration:
• Connection to Kubernetes API
• Pod/Namespace awareness
• Policy CRDs
b. Monitoring Systems:
• Metrics endpoints
• Prometheus integration
• Health checking
a. Sensor Management:
• Process execution tracking
• System call monitoring
• Network activity observation
• File access tracking
b. Policy Enforcement:
• TracingPolicy handling
• Runtime enforcement rules
• Filter management
Component Details
Labels for key features:
• Process lifecycle monitoring
• Security event detection
• Runtime enforcement
• Kubernetes awareness
• eBPF program management
Operational Flows
Main operational paths:
• Event generation and processing
• Policy application and enforcement
• Monitoring and alerting
• Configuration management
eBPF Integration
• Clear separation between kernel and user space
• BPF program attachment points
• Map usage for data sharing
Kubernetes Integration
• CRD handling
• Pod awareness
• Namespace filtering
Security Context
• Privilege boundaries
• Enforcement points
• Security policy flow
Scalability Aspects
• Parallel processing paths
• Buffering mechanisms
• Load distribution
• Real-time security observability
• eBPF-based implementation
• Kubernetes integration
• Policy-based enforcement
• Rich event metadata
This will provide a clear understanding of how Tetragon operates as a security observability and enforcement system while maintaining accuracy to its actual implementation.