ADR 0002Chấp nhận

ADR 0002: HTTPS + protobuf, không dùng gRPC

HTTPS REST, thân protobuf nén (zstd hoặc gzip), JSON chỉ để gỡ lỗi.

Ngày quyết định

30/09/2026

Chấp nhận

30/09/2026

Phạm vi

Collector

Người chấp nhận

Chưa ghi

1. Đề xuất30/09/2026
2. Chấp nhận30/09/2026

Trạng thái: Chấp nhận. Ngày: 2026-09-30.

Bối cảnh

Cần giao thức gọn, bền, đi qua proxy doanh nghiệp, dễ cân tải, dễ gỡ lỗi, nhiều nền tảng.

Lựa chọn

1. gRPC (HTTP/2, streaming).
2. HTTPS REST với JSON.
3. HTTPS REST với protobuf nén.

Quyết định

HTTPS REST, thân protobuf nén (zstd hoặc gzip), JSON chỉ để gỡ lỗi.

Lý do

• Nhiều proxy và tường lửa doanh nghiệp xử lý HTTP/1.1 kém với gRPC, và cân tải L7 cho gRPC phức tạp hơn.
• Request/response độc lập, không giữ kết nối dài, agent và collector không phải quản lý luồng.
• Protobuf gọn và có lược đồ có kiểm tra tương thích (buf breaking).
• Dễ dùng curl để chẩn đoán với chế độ JSON gỡ lỗi.
• Đơn giản để đưa đường dẫn enroll qua proxy sang Access Hub (REST).

Hệ quả

• Không có streaming hai chiều. Lệnh từ collector xuống agent chỉ qua thăm dò (config mỗi 5 phút hoặc config_etag trong phản hồi). Đủ cho phạm vi GĐ 1 đến 3.
• Phải tự thiết kế quy ước lỗi, phiên bản và giới hạn (đã làm ở 03-protocol).