How kubescape/node-agent works
Main Components
a. Core Components:
• Node Agent Core (Central Controller)
• eBPF Tracers/Gadgets
• Rule Engine
• Event Processors
• Storage System
• Exporters
b. External Integrations:
• Kubernetes API Server
• ClamAV Malware Scanner
• Prometheus Metrics
• Alert Manager
• Storage Backend
Component Relationships
Top Layer: External Systems
• Kubernetes API Server
• Prometheus
• Alert Manager
Middle Layer: Core Components
• Node Agent Core
• Container Watcher
• Process Manager
• Network Manager
• Application Profile Manager
• Security Components
• Rule Engine
• Rule Binding Manager
• Malware Manager (ClamAV)
• Event Processing
• Event Reporters
• Exporters (HTTP/Syslog/CSV)
Bottom Layer: System Level
• eBPF Gadgets
• HTTP Tracer
• SSH Tracer
• Ptrace Detector
• Hardlink Tracer
• RandomX Detector
• System Resources
Data Flow Indicators
• eBPF data collection flow from system to tracers
• Event processing flow through the system
• Alert and metric reporting paths
• Configuration and rule updates from Kubernetes
Key Elements to Highlight
a. Security Features:
• Malware scanning capabilities
• Runtime security monitoring
• Network traffic analysis
• File system monitoring
b. Integration Points:
• Kubernetes integration
• Monitoring system connections
• Alert routing
Implementation Details
• eBPF-based monitoring architecture
• Real-time security scanning capabilities
• Event processing pipeline
• Rule evaluation system
• Multiple exporter options
Technical Notes
Annotations for:
• CO-RE (Compile Once Run Everywhere) requirement
• Kernel version dependencies
• Security permissions needed
• Configuration requirements (NODE_NAME, KUBECONFIG)