Wdrażanie wizualizacji Grafana dla 3CX z Grafana Marketplace

Wprowadzenie

Wizualizacje 3CX Grafana są dostępne na Grafana Marketplace, co pozwala na szybkie i łatwe wdrażanie gotowych dashboardów 3CX. Ten przewodnik dotyczy 3CX w wersji 20, z aktualizacją 7 (SP7) i nowszych.

Funkcja konektorów danych wymaga licencji 16SC lub wyższej.

Wymagania wstępne

Przed wdrożeniem wtyczki 3CX Grafana upewnij się, że skonfigurowano następujące elementy:

  • Działający konektor danych (zobacz przewodniki dla):
  • Włączone opcje transferu danych dla metryk, które zamierzasz wizualizować w Grafana (np. historia połączeń (CDR), metryki systemowe itp.).

Krok 1: Rejestracja w Grafana

  • Odwiedź stronę Grafana i zarejestruj nowe konto (obsługiwany jest każdy poziom, w tym plan darmowy).
  • Jeśli tworzysz nowe konto, skonfiguruj swój stos Grafana (Grafana Stack) – będzie to podstawowy adres URL, pod którym hostowane są Twoje dashboardy.

Krok 2: Dodawanie źródła danych 3CX

W tym przykładzie użyjemy MySQL. W przypadku innych baz danych zapoznaj się z odpowiednią dokumentacją konektora danych.

  • Z ekranu głównego Grafana („Home”) rozwiń „Connections” (Połączenia) i wybierz „Add new connection” (Dodaj nowe połączenie).

  • Wybierz „MySQL Datasource” (lub wybrany typ konektora).

  • Wybierz opcję „Add new data source” (Dodaj nowe źródło danych).

  • Nazwij i dodaj wszystkie istotne szczegóły połączenia z bazą danych, a następnie wybierz „Save & Test” (Zapisz i przetestuj), aby potwierdzić.
  • Należy użyć użytkownika bazy danych posiadającego jedynie uprawnienia SELECT do tabel 3CX.

Możesz dodatkowo ograniczyć dostęp do swojej bazy danych, korzystając z listy dozwolonych adresów IP (Allow-List IPs) udostępnianej przez Grafana tutaj.

Krok 3: Konfiguracja wtyczki

  • Przejdź do Marketplace wtyczek z ekranu głównego Grafana: „Home”->„Administration” (Administracja)->„Plugins and data” (Wtyczki i dane)->„Plugins” (Wtyczki).

  • Na stronie wtyczki 3CX kliknij „Install” (Zainstaluj).

  • Po zakończeniu instalacji (od kilku sekund do kilku minut) pojawi się przycisk „Enable” (Włącz). Może być konieczne odświeżenie strony.
  • Gdy będzie widoczny, kliknij go.

  • Strona odświeży się, a nowa opcja „3CX (& Configuration)” pojawi się w sekcji „More Apps” (Więcej aplikacji).
  • Przejdź do „Configuration” (Konfiguracja) i wybierz wcześniej utworzone źródło danych. Jeśli wybrano kompatybilne źródło danych, pojawi się zielony znacznik wyboru, a opcja „Publish dashboards” (Opublikuj dashboardy) stanie się dostępna.
  • Kliknij ją, aby kontynuować.

Krok 4: Przeglądanie dashboardów

  • Strona powinna odświeżyć się automatycznie i otworzyć listę dashboardów w aplikacji 3CX.

  • Dashboardy będą teraz również dostępne w folderze 3CX w głównej sekcji „Dashboards”.

  • Kliknięcie dowolnego z nich natychmiast załaduje dostępne dane i rozpocznie ich wyświetlanie.

Krok 5: Wdrożenia wielosystemowe i dostosowywanie

Jeśli chcesz monitorować wiele instancji 3CX w ramach tego samego stosu Grafana (domeny) lub wprowadzać własne modyfikacje w dostarczonych szablonach, możesz tworzyć ich kopie za pomocą funkcji „Export” (Eksportuj). Znajduje się ona na górze widoku każdego dashboardu.

Następnie możesz je zaimportować z głównego panelu „Dashboards”. Zostaniesz poproszony o wybranie nowego, unikalnego identyfikatora dla tego dashboardu w swoim stosie, a także o wybór bazy danych (tego samego typu co w oryginalnym wdrożeniu), z którą ma się połączyć.

Krok 6: Alerty

Grafana pozwala na ustawienie wyzwalaczy alertów dla wszystkich śledzonych metryk. Jako przykład, oto jak dodać alert dla wysokiego zużycia procesora.

  • W dashboardzie „Health and Performance” (Kondycja i wydajność), wybierz „New alert rule” (Nowa reguła alertu), znajdującą się w menu „＋”.

  • Nazwij swój alert i zdefiniuj podstawowe parametry, które będą monitorowane.

  • Kontynuuj, konfigurując kolejne meta-parametry dla alertu, takie jak foldery i tagi, a także odbiorców alertu, jego treść oraz adres URL Runbooka.

Zobacz również


Ostatnia aktualizacja
Ten dokument został ostatnio zaktualizowany 15 stycznia 2026 r.
https://www.3cx.pl/docs/raportowanie-grafana-pbx/