47 lines
2.6 KiB
Markdown
47 lines
2.6 KiB
Markdown
---
|
|
summary: "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"
|
|
read_when:
|
|
- Bạn muốn tìm hiểu về danh sách các tệp/thiết bị đang kết nối tới Gateway
|
|
---
|
|
|
|
# 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
|
|
|
|
1. **Bản thân Gateway**: Luôn tự tạo một mục "tôi đang chạy" khi khởi động.
|
|
2. **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.
|
|
3. **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).
|
|
4. **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ị](../../start/pairing.vi.md), [Giao thức Gateway](../../gateway/protocol.vi.md).
|