Witamy w cXhub

1. Informacje ogólne

Platforma została stworzona z myślą o monitorowaniu wykorzystania instancji 3CX. W szczególności w zakresie uzyskania informacji o wykorzystaniu licencji tj. liczby połączeń jednoczesnych.

Obecnie jest to projekt pilotażowy w którym możesz uczestniczyć również Ty. Bez opłat, bez potrzeby rejestracji.

Rozwiązanie składa się z dwóch głównych elementów:

• Platforma cXhub gdzie dostępne są dane z Twojego systemu
• Aplikacja cXwatch instalowana na serwerze 3CX

2. Wykorzystywane dane

W ramach działania aplikacja cXwatch pobiera periodycznie (co 10 minut) dane z Twojej centrali 3CX. Zestaw ten nie zawiera żadnych danych wrażliwych w rozumieniu prawa.

Dane przesyłane są do bazy danych platformy cXhub w sposób bezpieczny, szyfrowany z wykorzystaniem protokołu HTTPS.

UWAGA! Aplikacja cXwatch posiada możliwość pobierania i przesyłania klucza licencyjnego z instancji 3CX. Nie jest to jednak wymagane do działania podstawowych funkcjonalności więc pobieranie oraz przesyłanie klucza licencyjnego jest domyślnie w aplikacji zablokowane - może być odblokowane wyłącznie świadomie i przy naszej pomocy.

W ramach projektu pilotażowego na platformie cXhub możliwy jest przegląd i analiza danych z ostatnich 14 dni kalendarzowych.

3. Przygotowania do instalacji

Instalacja aplikacji cXwatch wymaga dostępu SSH z uprawnieniami ROOT maszyny wirtualnej (lub fizycznej) z zainstalowanym oprogramowaniem do centrali 3CX.

Przed podjęciem dalszych kroków koniecznie wykonaj kopię bezpieczeństwa i zachowaj ją w bezpiecznym, dostępnym dla Ciebie miejscu. Zalecane jest wykonanie kopii bezpieczeństwa całego systemu, nie tylko konfiguracji oprogramownaia 3CX.

Ostrzeżenie. Producent oprogramowania 3CX nie zaleca instalacji żadnego oprogramowania zewnętrznego na tym samym systemie. Może to skutkować odrzucaniem zgłoszeń przez wsparcie producenta. W takiej sytuacji będzie koniecznie odinstalowanie aplikacji cXwatch przed wygenerowaniem 3CX Support Info.

Przed instalacją aplikacji cXwatch należy upewnić się czy nie była wcześniej instalowana i nie jest obecna w systemie.

Jeżeli wcześniejsza wersja aplikacji cXwatch jest obecna w systemie to należy ją usunąć.

# Sprawdź czy usługa jest już w systemie
sudo systemctl status cXwatch

Uwaga. Jeżeli w poprzednim kroku otrzymałeś komunikat "Unit cXwatch.service could not be found" zaleca się sprawdzenie czy w katalogu /opt/cXwatch na nie istnieje. Aplikacja mogła być wgrana, ale nie zarejestrowana jako usługa.

4. Pobieranie, instalacja i uruchomienie

Kolejnym krokiem jest instalacja aplikacji cXwatch w Twoim systemie.
Dla wygody przygotowany jest gotowy pakiet .deb zgodny z aktualną wersją systemu operacyjnego Linux Debian

Rozmiar aplikacji wynika z faktu iż posiada ona wbudowane środowisko uruchomieniowe Dotnet oraz wszyskie niezbędne do uruchomienia zależności.

wget https://downloads.cxtools.eu/cXwatch_1.0.3-1_amd64.deb

sudo dpkg -i cXwatch_1.0.3-1_amd64.deb

root@edison:~# systemctl status cXwatch

● cXwatch.service - cXwatch
     Loaded: loaded (/etc/systemd/system/cXwatch.service; enabled; preset: enabled)
     Active: active (running) since Wed 2026-10-21 11:31:04 CEST; 7s ago
   Main PID: 2654845 (cXwatch)
      Tasks: 25 (limit: 19144)
     Memory: 51.4M
        CPU: 1.021s
     CGroup: /system.slice/cXwatch.service
             └─2654845 /opt/cXwatch/cXwatch

paź 21 11:31:08 edison cXwatch[2654845]: cXwatch version 1.0.3
paź 21 11:31:08 edison cXwatch[2654845]: Instance unique id: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

5. Odinstalowanie aplikacji cXwatch

Odinstalowanie aplikacji cXwatch należy przeprowadzić korzystając z menedżera pakietów

# Standardowe odinstalowanie aplikacji
sudo dpkg -r cXwatch

# Odinstalowanie z wymuszeniem usunięcia wszystkich plików konfiguracyjnych
sudo dpkg --purge cXwatch

6. Jak używać

Postępuj zgodnie z poniższym przewodnikiem krok po kroku, aby poruszać się po cXhub, wybierać monitorowane instancje centrali 3CX PBX, analizować telemetrię ruchu połączeń oraz przeglądać historyczne wskaźniki wydajności.

Aby uzyskać dostęp do danych w portalu cXhub będziesz potrzebował unikalnego identyfikatora Twojej instancji. Jeżeli go nie zapamiętałeś to zaloguj się do konsoli SHH swojj centrali 3CX i wywołaj poniższe polecenie.

root@edison:~# journalctl -u cXwatch -r | grep -m 1 'Instance unique id'
paź 20 16:14:49 edison cXwatch[2640476]: Instance unique id: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

7. Wsparcie

Potrzebujesz pomocy lub masz pytania dotyczące integracji i przepływów pracy?
Skontaktuj się z naszym zespołem wsparcia Support Halo2.