Konfiguracja niestandardowego serwera Syslog - 3CX

Wprowadzenie

Opcja niestandardowego serwera Syslog (Custom Syslog Server) umożliwia przesyłanie zdarzeń systemowych oraz logów audytowych z 3CX do dowolnego standardowego kolektora syslog ( takiego jak rsyslog, syslog-ng czy Kiwi Syslog). Jest to rozwiązanie zazwyczaj stosowane w przypadku lokalnych serwerów logowania lub systemów zarządzania informacjami i zdarzeniami bezpieczeństwa (SIEM) w ramach sieci lokalnej.

Krok 1: Przygotuj swój serwer Syslog

Przed skonfigurowaniem systemu 3CX upewnij się, że docelowy serwer syslog jest gotowy na przyjmowanie ruchu zewnętrznego:

  • Identyfikacja adresu IP / nazwy hosta: Zanotuj wewnętrzny lub zewnętrzny adres IP swojego serwera logowania.
  • Otwarcie portów na zaporze sieciowej: Upewnij się, że zapora sieciowa serwera zezwala na ruch przychodzący z centrali PBX na wybranym porcie (zazwyczaj jest to port 514 dla standardowego protokołu syslog).
  • Włączenie zdalnego odbierania: Potwierdź, że usługa syslog (np. rsyslog) jest skonfigurowana do nasłuchiwania komunikatów zdalnych, ponieważ domyślnie wiele z nich odbiera tylko wiadomości lokalne.
  • Zapoznaj się z sekcją „Instalacja Rsyslog na systemie Debian” poniżej, aby rozpocząć.

Krok 2: Skonfiguruj zdalny Syslog w 3CX

  • Przejdź do: Konsola administracyjna > „Integrations” (Integracje) > „Remote Syslog” (Zdalny Syslog).
  • W rozwijanym menu „Remote Logging Provider” (Dostawca zdalnego logowania) wybierz opcję „Custom Syslog Server”.
  • Syslog Server Address: Wprowadź adres IP lub pełną nazwę domenową (FQDN) swojego serwera.
  • Port: Wprowadź numer portu, na którym nasłuchuje Twój serwer (domyślnie jest to 514, ale sprawdź konfigurację swojego serwera).
  • Transport Protocol: Wybierz protokół wymagany przez Twój serwer:
  • UDP: Najpopularniejszy dla usługi syslog; szybki, ale nie gwarantuje dostarczenia pakietów.
  • TCP: Niezawodny, ponieważ potwierdza odbiór pakietów.
  • TLS: Szyfruje logi podczas przesyłania (wymaga ważnego certyfikatu po stronie odbiorczej).
  • mTLS: W przypadku wyboru TLS umożliwia opcjonalne przesłanie wymaganego certyfikatu i klucza klienta, jeśli serwer syslog jest skonfigurowany do weryfikacji centrali PBX.
  • W sekcji „Data to Export” (Dane do eksportu) wybierz żądane logi:
  • System Alerts: Krytyczne użycie zasobów systemowych i problemy ze stanem systemu (wymaga włączenia i skonfigurowania progów alertów w menu „Admin” > „System” > „Alerts”).
  • 3CX Alerts: Zdarzenia specyficzne dla centrali PBX, takie jak status trunków SIP, zatrzymane usługi czy czarna lista adresów IP.
  • Audit Logs: Historia zmian ustawień wprowadzonych przez administratorów.
  • Kliknij przycisk „Save” (Zapisz) na górze strony.

Krok 3: Weryfikacja połączenia

  • Kliknij przycisk „Test” na górze strony 3CX Remote Syslog. System 3CX wyśle standaryzowaną wiadomość testową do Twojego serwera.
  • Na serwerze syslog sprawdź pliki logów (np. /var/log/syslog w systemie Linux), aby potwierdzić nadejście wiadomości testowej. Zazwyczaj pojawi się ona z identyfikatorem 3CX Hello.

Jeśli na przykład chcesz monitorować komunikaty serwera syslog pod kątem wiadomości przychodzących z „mypbx.3cx-example.com”:

root@mysyslog.3cx-example.com:~# tail -f /var/log/syslog | grep mypbx.3cx-example.com

2026-05-21T10:55:52+03:00 mypbx.3cx-example.com SyslogIntegrationTest 3CX says 'hello' to Custom

2026-05-21T11:05:47+03:00 mypbx.3cx-example.com EventLog {"id":257,"timestamp":"2026-05-21T08:05:47.0770000Z","message":"3CX Transcription Engine connection lost – transcription of voicemails and calls suspended","template":"3CX Transcription Engine connection lost – transcription of voicemails and calls suspended","params":[""],"source":"Web Manager","type":2,"event_id":50042,"group_name":"System wide"}

2026-05-21T11:16:50+03:00 mypbx.3cx-example.com SyslogIntegrationTest 3CX says 'hello' to Custom

Parametry niestandardowe dla zaawansowanych wdrożeń

W środowiskach, w których domyślne ustawienia nie do końca odpowiadają wymaganiom, system 3CX udostępnia parametr SYSLOG_MESSAGE_FORMAT.

3CX obsługuje oba główne standardy Syslog i pozwala na przełączanie się między nimi. Domyślnie 3CX używa formatu RFC5424 – nowoczesnego, bardziej ustrukturyzowanego formatu preferowanego przez większość współczesnych systemów SIEM.

Jeśli Twój kolektor jest starszej generacji lub standaryzujesz środowisko na starszym formacie, ustaw parametr na RFC3164, a system 3CX odpowiednio sformatuje wiadomości wychodzące. Dla porównania poniżej przedstawiono, jak każdy z formatów wygląda w praktyce:

  • RFC3164: <191>Dec 10 11:59:56 mypbx.3cx-example.com SyslogIntegrationTest: 3CX says 'hello' to SyslogServer
  • RFC5424: <191>1 2026-01-15T14:06:50+02:00 mypbx.3cx-example.com SyslogIntegrationTest - - - 3CX says 'hello' to SyslogServer

W obu przypadkach <191> oznacza priorytet wiadomości, znacznik czasu podany jest w czasie UTC, mypbx.3cx-example.com to FQDN centrali PBX, a znacznik aplikacji wskazuje źródło zdarzenia. Możliwe znaczniki aplikacji obejmują: SyslogIntegrationTest, EventLog, AuditLog oraz Telemetry. Wszystko po nich stanowi właściwą treść wiadomości (payload).

Instalacja Rsyslog na systemie Debian

  1. Połącz się przez SSH z maszyną z systemem Debian i uruchom poniższe polecenia, aby zainstalować i włączyć usługę rsyslog:

sudo apt update

sudo apt install rsyslog

sudo systemctl enable rsyslog

sudo systemctl start rsyslog

  1. Edytuj główny plik konfiguracyjny usługi rsyslog:

nano /etc/rsyslog.conf

  1. Dodaj lub odkomentuj poniższe linie w zależności od protokołu, który chcesz obsługiwać (tj. UDP/TCP), i zapisz plik:

# provides UDP syslog reception

module(load="imudp")

input(type="imudp" port="514")

# provides TCP syslog reception

module(load="imtcp")

input(type="imtcp" port="514")

  1. Uruchom ponownie usługę rsyslog, aby zmiany weszły w życie:

sudo systemctl restart rsyslog



Ostatnia aktualizacja
Ten dokument został ostatnio zaktualizowany 10 września 2026 r.
https://www.3cx.pl/docs/custom-syslog-server/