Tổng quan

Hướng dẫn này sẽ giúp bạn nhanh chóng thiết lập và chạy G-BlackHole Agent trong vài phút. Chúng ta sẽ:

1. Xác thực với Registry (nếu sử dụng)
2. Chạy Agent ở foreground để test
3. Cài đặt Agent như service

Bước 1: Xác thực với Registry (tùy chọn. Forwarder có thể tự động xác thực thay cho Agent)

Nếu bạn sử dụng Registry server, hãy xác thực trước:

Windows

# Xác thực với Registry
.\blackhole-agt.exe auth --key "your-api-key-here"

Linux

# Xác thực với Registry
./blackhole-agt auth --key "your-api-key-here"

Bước 2: Chạy Agent ở Foreground

Test Agent bằng cách chạy ở foreground để xem logs trực tiếp:

Windows

# Chạy Agent ở foreground với verbose logging
.\blackhole-agt.exe start --config config.yml --verbose

# Hoặc với log level debug
.\blackhole-agt.exe start --config config.yml --log-level debug

Linux

# Chạy Agent ở foreground với verbose logging
./blackhole-agt start --config config.yml --verbose

# Hoặc với log level debug
./blackhole-agt start --config config.yml --log-level debug

Kiểm tra hoạt động:

• Xem logs trên console để đảm bảo Agent đang thu thập dữ liệu
• Kiểm tra các collector đang chạy (APM, File, Windows Events)
• Xác nhận dữ liệu được gửi đến sink (Registry nếu đã cấu hình)

Dừng Agent:

• Nhấn Ctrl+C để dừng Agent

Bước 3: Cài đặt Agent như Service

Sau khi test thành công, cài đặt Agent như service để chạy tự động:

Windows

# Cài đặt Windows Service
.\blackhole-agt.exe service install --config config.yml

# Khởi động service
.\blackhole-agt.exe service start

# Kiểm tra trạng thái service
Get-Service -Name "blackhole-agt"

Linux

# Cài đặt systemd service
sudo ./blackhole-agt service install --config config.yml

# Khởi động service
sudo ./blackhole-agt service start

# Kiểm tra trạng thái service
sudo systemctl status blackhole-agt

Xác minh cài đặt

Kiểm tra Service Status

Windows:

# Xem trạng thái service
Get-Service -Name "blackhole-agt"

# Xem logs của service
Get-EventLog -LogName Application -Source "blackhole-agt" -Newest 10

Linux:

# Xem trạng thái service
sudo systemctl status blackhole-agt

# Xem logs của service
sudo journalctl -u blackhole-agt -f

Kiểm tra Logs

Windows:

# Xem log files
Get-Content ".\logs\default.log" -Tail 20
Get-Content ".\logs\agent-error.log" -Tail 10

Linux:

# Xem log files
tail -f /var/log/blackhole-agent/default.log
tail -f /var/log/blackhole-agent/default-error.log

Tóm tắt lệnh

Windows

# Quick Start Commands
.\blackhole-agt.exe auth --key "your-api-key-here"  # Nếu dùng Registry
.\blackhole-agt.exe start --config config.yml --verbose  # Test
.\blackhole-agt.exe service install --config config.yml
.\blackhole-agt.exe service start

Linux

# Quick Start Commands
./blackhole-agt auth --key "your-api-key-here"  # Nếu dùng Registry
./blackhole-agt start --config config.yml --verbose  # Test
sudo ./blackhole-agt service install --config config.yml
sudo ./blackhole-agt service start