Giới thiệu

BlackHole Agent là thành phần thu thập log chạy trên máy chủ và endpoint. Nó thu thập dữ liệu từ nhiều nguồn khác nhau và gửi đến các hệ thống backend như MQTT, Kafka, hoặc BlackHole (OpenSearch).

Agent có thể hoạt động độc lập hoặc kết hợp với Forwarder trong môi trường phân tán.

Tính năng chính

Thu thập dữ liệu

• APM Metrics: Thu thập CPU, memory, disk, network và process information
• File Logs: Theo dõi log real-time với hỗ trợ log rotation
• Windows Event Logs: Thu thập từ Application, Security, System (chỉ Windows)
• SCA: Đánh giá cấu hình bảo mật theo policy Wazuh (từ v0.5.4+)

Điều phối và quản lý

• Orchestrator: Điều phối luồng dữ liệu giữa sources và sinks
• Hot-reload: Cập nhật cấu hình khi đang chạy mà không cần restart
• Inventory: Queue persistent để đảm bảo dữ liệu không bị mất khi gặp lỗi

Tích hợp

• Registry: Kết nối với server trung tâm để đồng bộ cấu hình (tùy chọn)
• Service: Chạy như Windows Service hoặc systemd service
• TLS/SSL: Hỗ trợ mã hóa tất cả kết nối

Nền tảng hỗ trợ

Nền tảng	Chi tiết
Windows	Windows 10/11, Windows Server 2016+. Architecture x64.
Linux	Ubuntu, CentOS, RHEL, Debian, Alpine. Architecture x86_64, ARM64. Hỗ trợ musl libc cho Alpine.

Yêu cầu hệ thống

Thành phần	Tối thiểu	Khuyến nghị
CPU	1 core, 1GHz	2+ cores, 2GHz+
Memory	512MB RAM	1.5GB+ RAM
Disk	100MB free	2GB+ free
Network	Internet (nếu dùng Registry)	Băng thông ổn định

Bảo mật

• Xác thực với Registry bằng API key (tùy chọn)
• TLS/SSL cho tất cả kết nối
• Device token cho giao tiếp sau xác thực
• Hỗ trợ HTTP/HTTPS proxy

Logging

• Structured logging với tracing crate
• Các level: debug, info, warn, error
• Tự động log rotation khi file đạt max_size_mb