Lightweight
Đẩy dữ liệu qua Sensor
Hướng dẫn đẩy dữ liệu qua Sensor theo phương thức Lightweight
Phương thức triển khai: Lightweight
Hiện tại, hệ thống hỗ trợ triển khai Sensor theo mô hình Lightweight với các đặc điểm nổi bật:
- Cài đặt trực tiếp: Tích hợp thẳng vào các máy chủ hoặc thiết bị của khách hàng.
- Tối ưu tài nguyên: Thiết kế siêu nhẹ giúp Sensor hoạt động ở chế độ nền với mức chiếm dụng tài nguyên cực thấp (dưới 1% CPU).
- Đảm bảo hiệu năng: Quá trình theo dõi và đẩy dữ liệu diễn ra hoàn toàn trong suốt, không gây bất kỳ ảnh hưởng nào đến hiệu suất hoạt động của máy chủ gốc.
Yêu cầu kỹ thuật
| Thành phần | Mô tả |
|---|---|
| Network Requirements | Giao thức: HTTPS/TCP Các Endpoint cần mở kết nối: 1. Endpoint tiếp nhận log (Log Ingestion Endpoint) - URL: https://ingress-hcm01.csp.cmctelecom.io/events- Port: 443- Mục đích: Tiếp nhận log từ Sensor và chuyển tiếp vào nền tảng SecOps. 2. Endpoint API của Sensor (Sensor API Endpoint) - URL: https://api-secops.csp.cmctelecom.io- Port: 443- Mục đích: Đăng ký Sensor (Enrollment), đồng bộ cấu hình và giao tiếp với các API của hệ thống. 3. Endpoint Gateway của Sensor (Sensor Gateway Endpoint) - Host: sensor-gw-hcm01.csp.cmctelecom.io- Port: 4320- Mục đích: Kết nối giữa Sensor và Gateway để gửi heartbeat, giám sát trạng thái hoạt động và nhận cấu hình/chính sách từ hệ thống. Yêu cầu Firewall: - Cho phép kết nối outbound từ máy cài Sensor tới các endpoint trên. - Đảm bảo các port 443 và 4320 có thể truy cập được. |
| Sensor deployment | - Sensor được cài đặt trên server / endpoint cần thu thập log - Hỗ trợ hệ điều hành: Windows, Linux - Hỗ trợ cài đặt qua Script |
| Authentication | - Sử dụng Key để xác thực |
| Authorization | - Chỉ được phép gửi dữ liệu trong phạm vi file được cấp quyền |
| Rate limit | Để đảm bảo tính ổn định và an toàn, hệ thống áp dụng các giới hạn sau: - Kích thước tối đa: 1MB mỗi request - Tốc độ gửi tối đa: 10 request/ giây (10 RPS) Việc vượt quá giới hạn có thể dẫn đến request bị từ chối. |
Các bước cài đặt Sensor
Để cài đặt Sensor, người dùng cần thực hiện theo 3 bước tuần tự:
Viết Config → Tạo Enrollment key → Cài đặt Sensor.
Bước 1: Khởi tạo cấu hình nhận và đẩy log (Create Config)
Trước khi cài đặt phần mềm lên máy chủ, ngừoi dùng cần định nghĩa trước Sensor sẽ lấy logs từ đâu và xử lý như nào.
- Từ thanh menu bên trái, chọn Data Collections → Sensors → Config
- Tạo mới: Nhấn nút "Create Config", nhập tên cấu hình tại ô "Config name" và chọn "Create".
- Chỉnh sửa cấu hình: Hệ thống sẽ hiển thị một nội dung mẫu (template). Bạn thực hiện thay đổi cấu hình dựa trên template này. Đọc chi tiết
- Kiểm tra & Kích hoạt:
- Chọn nút "Test" tại khung "Test config" để kiểm tra lỗi cú pháp.
- Chọn "Save as draft" để lưu bản nháp.
- Chọn "Publish" để chính thức kích hoạt cấu hình này (Hệ thống chỉ cho phép Publish sau khi đã Save as draft).
Bước 2: Tạo mã xác thực kết nối (Enrollment key)
Enrollment key đóng vai trò là "chìa khóa" Sensor kết nối an toàn với hệ thống CMC SecOps.
- Từ thanh menu bên trái, chọn Data Collections → Sensors → Enrollment.
- Tại giao diện Enrollment Keys, nhấn nút "Create key".
- Thiết lập các thông tin bắt buộc trong popup:
- Key name (Bắt buộc): Đặt tên cho key để dễ quản lý mã xác thực.
- Config: Chọn bản Config đã tạo ở Bước 1 để gán vào Key này
Lưu ý: Hệ thống chỉ cho phép chọn các Config đang ở trạng thái Published. Các bản Draft sẽ không hiển thị tại đây.
- Chọn button "Create" để hoàn tất quá trình tạo key.
Bước 3: Tải và cài đặt tự động qua dòng lệnh (Command Line)
Khi đã có cấu hình và chìa khóa xác thực, bạn tiến hành cài đặt Sensor trực tiếp lên máy chủ cần thu thập log.
- Từ thanh menu bên trái, chọn Data Collections → Sensors → Sensor
- Mở form cài đặt: Nhấn nút "Install Sensor" và điền các thông tin trong popup:
- Select Type (Bắt buộc): Chọn Light weight
- Select enrollment key (Bắt buộc): Chọn key bạn vừa tạo ở Bước 2
- OS (Bắt buộc): Chọn OS của máy bạn chuẩn bị cài Sensor. Hệ thống hỗ trợ 2 loại OS (Linux / Windows)
- Chạy lệnh cài đặt: Hệ thống sẽ tự động sinh ra một đoạn mã lệnh (Command line) tương ứng. Bạn chỉ cần Copy đoạn lệnh này và Paste chạy trực tiếp trên Terminal (Linux) hoặc Command Prompt (Windows) của máy chủ. Quá trình tải và cài đặt sẽ diễn ra hoàn toàn tự động.
Bước 4: Kiểm tra trạng thái và Log
- Kiểm tra trạng thái: Sau khi cài đặt xong, máy chủ sẽ xuất hiện trong danh sách Sensor list view với các trạng thái:
| Trạng thái | Mô tả |
|---|---|
| Pending | Trạng thái mặc định khi Sensor được cài trên máy người dùng. |
| Active | Trạng thái Sensor gửi chỉ số health check. Cứ 2 phút Sensor sẽ gửi chỉ số health check về lần, nếu có thì trạng thái là Active |
| Error | Nếu Sensor không gửi chỉ số health check thì trạng thái là Error kèm lỗi gửi về. |
- Người dùng có thể vào trực tiếp màn hình Search, chọn đúng Data Connection vừa tạo để xem các log dữ liệu bắt đầu đẩy về hệ thống.