2.6 KiB
2.6 KiB
| summary | read_when | |
|---|---|---|
| Trạng thái hiện diện trong Moltbot: Cách tạo, gộp và hiển thị danh sách hoạt động |
|
Trạng thái hiện diện (Presence)
Trạng thái hiện diện trong Moltbot là một cái nhìn tổng quan nhanh về:
- Chính bản thân Gateway.
- Các ứng dụng khách (clients) đang kết nối tới Gateway (ứng dụng Mac, WebChat, CLI, v.v.).
Thông tin này chủ yếu dùng để hiển thị trong tab Instances của ứng dụng macOS và giúp người quản trị biết ai đang truy cập hệ thống.
Các thông tin hiển thị
Mỗi bản ghi trạng thái bao gồm các trường như:
instanceId: Định danh cố định của thiết bị kết nối.host: Tên máy tính.ip: Địa chỉ IP của thiết bị.version: Phiên bản của ứng dụng khách.mode: Loại kết nối (ví dụ:ui- giao diện đồ họa,cli- dòng lệnh,node- thiết bị đầu cuối).reason: Lý do ghi nhận trạng thái (kết nối mới, cập nhật định kỳ).ts: Thời điểm cập nhật cuối cùng.
Nguồn tạo trạng thái
- Bản thân Gateway: Luôn tự tạo một mục "tôi đang chạy" khi khởi động.
- Khi kết nối WebSocket: Mọi ứng dụng khi kết nối sẽ khai báo thông tin của mình.
- Lưu ý: Các lệnh CLI ngắn gọn (chỉ chạy rồi tắt) thường sẽ không hiển thị để tránh làm rối danh sách.
- Tín hiệu đèn báo (system-event beacons): Các ứng dụng gửi thông tin cập nhật định kỳ (như thời gian người dùng không hoạt động).
- Kết nối của các Node: Khi bạn ghép nối camera hay màn hình, chúng cũng xuất hiện trong danh sách này.
Quy tắc xóa bỏ (TTL)
Trạng thái hiện diện chỉ mang tính chất tạm thời:
- Các mục không cập nhật trong vòng 5 phút sẽ bị tự động xóa.
- Danh sách tối đa là 200 mục (mục cũ nhất sẽ bị đẩy ra nếu danh sách đầy).
Điều này đảm bảo danh sách luôn mới và không chiếm dụng bộ nhớ hệ thống.
Mẹo gỡ lỗi
Để xem danh sách thô của tất cả các thiết bị đang hiện diện, bạn có thể thực hiện yêu cầu system-presence tới Gateway.
Tài liệu liên quan: Ghép nối thiết bị, Giao thức Gateway.