# RustDesk Server OSS Monitoring for Zabbix

Мониторинг [RustDesk Server OSS](https://rustdesk.com/) через **Zabbix Agent 2**.

Проект предназначен для Docker-инсталляции RustDesk Server с контейнерами `hbbs` и `hbbr`.

Мониторинг позволяет получать:

- количество зарегистрированных RustDesk peers;
- IP зарегистрированных peers;
- автоматическое обнаружение peers через Zabbix LLD;
- количество активных TCP-соединений `hbbr`;
- количество активных relay-сессий;
- список IP активных relay-клиентов;
- JSON со сводной информацией.

## Возможности

| Метрика | Zabbix key | Тип |
|---|---|---|
| Registered peers | `rustdesk.peers` | Numeric |
| Peer IP | `rustdesk.peer.ip[ID]` | Text |
| Peer discovery | `rustdesk.discovery` | LLD |
| Relay connections | `rustdesk.relay.connections` | Numeric |
| Relay sessions | `rustdesk.relay.sessions` | Numeric |
| Active relay IPs | `rustdesk.relay.ips` | Text |
| Summary JSON | `rustdesk.json` | Text |

## Архитектура

```text
                     ┌──────────────────────┐
                     │     Zabbix Server    │
                     └──────────┬───────────┘
                                │
                                │ Zabbix Agent 2
                                ▼
                     ┌──────────────────────┐
                     │   Linux RustDesk     │
                     │       Server         │
                     └──────────┬───────────┘
                                │
                  ┌─────────────┴─────────────┐
                  │                           │
                  ▼                           ▼
          ┌──────────────┐           ┌──────────────┐
          │     hbbs     │           │     hbbr     │
          │ RustDesk ID  │           │ Relay Server │
          └──────┬───────┘           └──────┬───────┘
                 │                          │
                 ▼                          ▼
          db_v2.sqlite3              TCP :21117
                 │                          │
                 │                   network namespace
                 │                          │
                 └──────────┬───────────────┘
                            ▼
                  rustdesk-monitor.sh
                            │
                            ▼
                    Zabbix UserParameter