RESOTài liệu

Phân Tích — Chỉ số hệ thống

Theo dõi số liệu hệ thống, tổng quan phân tích, và giám sát hiệu suất của toàn bộ nền tảng Reso — backend, database, livestream, xác thực.

Phân Tích — Số Liệu Hệ Thống

Analytics

Analytics là nơi admin theo dõi "sức khỏe kỹ thuật" của platform Reso. Khác với Finance (tài chính) hay Dashboard (vận hành), Analytics tập trung vào system metrics — hiệu suất backend, database, livestream service, và auth.

Trang Analytics kéo dữ liệu từ các endpoint:

  • GET analytics/system — analytics tổng quan hệ thống
  • GET system/metrics — metrics chi tiết realtime

Bạn có thể làm gì trong Analytics?

Hành độngMô tả
Xem system metricsCPU, memory, latency, error rate
Xem analytics overviewTổng quan traffic, request count, active users
Performance monitoringResponse time, throughput, bottleneck detection
Kiểm tra service healthBackend, DB, Agora, Supabase Auth

Chỉ Số Hệ Thống

Khi vào /admin/analytics, bạn thấy dashboard system metrics. Dữ liệu từ GET system/metrics — gần-realtime (delay vài giây).

Các chỉ số chính

Chỉ sốÝ nghĩa
CPU usage% CPU backend đang dùng
Memory usage% RAM backend đang dùng
Request rateSố request/giây đến backend
Avg response timeThời gian phản hồi trung bình (ms)
Error rate% request trả lỗi (5xx)
Active connectionsSố connection đang mở đến DB

Nếu Error rate > 1% hoặc Avg response time > 500ms, thông báo infra ngay. Platform đang có vấn đề performance cần xử lý.

Phân Tích overview

Tab Overview hiển thị traffic và usage tổng quan. Dữ liệu từ GET analytics/system.

  • Request count theo ngày/tuần
  • Unique IP truy cập
  • Geographic distribution (nước/region)
  • Biểu đồ xu hướng 7 ngày / 30 ngày
  • Concurrent users realtime
  • DAU / MAU (khớp Dashboard)
  • Session duration trung bình
  • Retention rate (day 1, day 7, day 30)
  • Concurrent streams realtime
  • Total stream hours theo ngày
  • Avg viewers per stream
  • Agora channel count
  • Stream quality (bitrate, resolution distribution)

Hiệu Năng monitoring

Tab Performance cho bạn xem chi tiết hiệu suất backend:

MetricMô tảNgưỡng cảnh báo
API response timeThời gian mỗi endpoint phản hồi> 500ms
DB query timeThời gian query database> 200ms
Agora latencyĐộ trễ livestream> 2 giây
Auth latencyThời gian verify JWT> 100ms
ThroughputRequest xử lý/giâygiảm > 50% so với baseline

Mở tab Performance

Từ Analytics, click tab Performance.

Kiểm tra response time theo endpoint

Xem endpoint nào chậm nhất. Nếu 1 endpoint chậm, có thể query DB cần optimize. Nếu tất cả chậm, có thể backend overload.

Kiểm tra DB query time

Query chậm → index thiếu hoặc query phức tạp. Escalate infra team.

Kiểm tra Agora latency

Livestream lag → kiểm tra region Agora, network. Nếu viewer report lag, đối chiếu ở đây.

Mẹo: Lưu baseline performance khi platform ổn định. Khi có anomaly, so sánh với baseline để biết vấn đề nghiêm trọng hay chỉ tăng trưởng tự nhiên.

Sức Khỏe Dịch Vụ

Analytics cũng hiển thị trạng thái từng service (khớp với Dashboard nhưng chi tiết hơn):

ServiceMetrics theo dõi
Backend API (NestJS)Uptime, response time, error rate, memory
Database (Supabase)Connection pool, query time, slow queries
Livestream (Agora)Channel count, latency, bitrate, error
Auth (Supabase)JWT verify time, login success rate
Edge FunctionsInvocation count, error rate, duration

Workflow monitoring hằng ngày

Mở Analytics đầu ca

Sau Dashboard, vào Analytics để kiểm tra system health. Đảm bảo tất cả service ok.

Kiểm tra error rate và response time

Nếu error rate cao hoặc response time tăng, điều tra ngay. Platform issue ảnh hưởng tất cả user.

Kiểm tra livestream metrics

Nếu có session live, đảm bảo Agora latency ổn. Viewer report lag → đối chiếu metrics.

Cuối ca — note anomaly

Nếu có anomaly trong ca, note lại vào kênh nội bộ để ca sau theo dõi.

Khi phát hiện vấn đề

Xác định scope

1 service hay nhiều service? 1 endpoint hay toàn backend? Giúp thu hẹp nguyên nhân.

Kiểm tra timing

Vấn đề bắt đầu khi nào? Có trùng với deploy mới không? Có trùng với traffic spike không?

Nâng Cấp Cơ Sở Hạ Tầng

Admin không fix backend. Thông báo infra team qua kênh nội bộ với:

  • Service affected
  • Metrics anomaly (số cụ thể)
  • Timing (khi nào bắt đầu)
  • Impact (bao nhiêu user affected)

Theo Dõi

Sau khi infra fix, kiểm tra lại Analytics để confirm metrics trở lại bình thường.

Admin Portal chỉ để quan sát, không fix infra. Đừng cố restart service hay sửa config từ Admin Portal. Mọi fix infra do đội infra đảm nhận. Admin chỉ escalate với thông tin rõ ràng.

Câu Hỏi Thường Gặp

Dữ liệu Analytics realtime đến đâu? System metrics (CPU, memory, error rate) gần-realtime (delay 5-10 giây). Analytics overview (traffic, retention) aggregate theo chu kỳ, có thể chậm 15-30 phút.

Tôi có thể export analytics không? Hiện tại Analytics không có nút export. Nếu cần, screenshot dashboard hoặc liên hệ infra để query trực tiếp DB.

Metrics nào quan trọng nhất? Error rate và response time — hai chỉ số trực tiếp ảnh hưởng trải nghiệm user. Nếu hai chỉ số này ổn, platform đang khỏe.

Sẵn sàng cấu hình hệ thống? Xem Settings.