So konfigurieren Sie einen benutzerdefinierten Syslog-Server für 3CX

Einführung

Mit der Option „Benutzerdefinierter Syslog-Server“ können Sie 3CX-Systemereignisse und Auditprotokolle an einen beliebigen Standard-Syslog-Sammler (wie rsyslog, syslog-ng oder Kiwi Syslog) senden. Dies wird häufig für lokale Protokollierungsserver oder SIEM-Systeme (Security Information and Event Management) in Ihrem lokalen Netzwerk verwendet.

Schritt 1: Syslog-Server vorbereiten

Stellen Sie vor der Konfiguration von 3CX sicher, dass Ihr Ziel-Syslog-Server bereit ist, externen Datenverkehr zu empfangen.

  • IP/Hostnamen ermitteln: Notieren Sie die interne oder externe IP-Adresse Ihres Protokollierungsservers.
  • Firewall-Ports öffnen: Stellen Sie sicher, dass die Firewall des Servers eingehenden Datenverkehr von Ihrer Telefonanlage auf dem gewählten Port zulässt (in der Regel 514 für Standard-Syslog).
  • Empfang aus der Ferne aktivieren: Bestätigen Sie, dass Ihr Syslog-Dienst (z. B. rsyslog) so konfiguriert ist, dass er auf Remote-Meldungen hört, da viele standardmäßig nur auf lokale Meldungen eingestellt sind.
  • Werfen Sie einen Blick auf den Abschnitt „Installation von Rsyslog unter Debian“ weiter unten, um zu beginnen.

Schritt 2: 3CX Remote Syslog konfigurieren

Schritt 2: 3CX Remote Syslog konfigurieren

  • Gehen Sie in der 3CX-Verwaltungskonsole zu Integrationen > Remote Syslog.
  • Stellen Sie das Dropdown-Menü „Remote-Protokollierungsanbieter“ auf „Benutzerdefinierter Syslog-Server“ ein.
  • Syslog-Serveradresse: Geben Sie die IP-Adresse oder den vollqualifizierten Domänennamen (FQDN) Ihres Servers ein.
  • Port: Geben Sie die Portnummer ein, auf der Ihr Server lauscht (Standard ist 514, überprüfen Sie jedoch Ihre Serverkonfiguration).
  • Übertragungsprotokoll: Wählen Sie das von Ihrem Server benötigte Protokoll aus:
  • UDP: Am gebräuchlichsten für Syslog; schnell, garantiert jedoch keine Zustellung.
  • TCP: Zuverlässiger, da der Paketempfang bestätigt wird.
  • TLS: Verschlüsselt die Protokolle während der Übertragung (erfordert ein gültiges Zertifikat auf der Empfängerseite).
  • mTLS: Falls Sie TLS auswählen, laden Sie optional das erforderliche Client-Zertifikat und den Schlüssel hoch, falls Ihr Syslog-Server so konfiguriert ist, dass er auch die Telefonanlage verifiziert.
  • Wählen Sie im Abschnitt „Zu exportierende Daten“ die gewünschten Protokolle aus:
  • Systembenachrichtigungen: Kritische Systemressourcenauslastung und Gesundheitsprobleme (Erfordert die Aktivierung und Konfiguration von Benachrichtigungsschwellenwerten unter Verwaltung > System > Benachrichtigungen).
  • 3CX-Warnungen: PBX-spezifische Ereignisse wie Trunk-Status, gestoppte Dienste oder IP-Sperrlisten.
  • Auditprotokolle: Eine Historie der von Administratoren geänderten Einstellungen.
  • Klicken Sie oben auf der Seite auf „Speichern“.

Schritt 3: Verbindung überprüfen

  • Klicken Sie oben auf der Seite „3CX Remote Syslog“ auf die Schaltfläche Testen. 3CX sendet eine standardisierte Testnachricht an Ihren Server.
  • Überprüfen Sie auf Ihrem Syslog-Server Ihre Protokolldateien (z. B. /var/log/syslog unter Linux), um den Eingang der Testnachricht zu bestätigen. Sie wird normalerweise mit der Kennung „3CX Hello“ angezeigt.

Wenn Sie beispielsweise Ihre Syslog-Servernachrichten auf eingehende Nachrichten von „mypbx.3cx-example.com“ überwachen möchten:

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

Benutzerdefinierte Parameter für erweiterte Bereitstellungen

Für Umgebungen, in denen die Standardeinstellungen nicht ganz passen, stellt 3CX den Parameter SYSLOG_MESSAGE_FORMAT zur Verfügung.

3CX unterstützt die beiden wichtigsten Syslog-Standards, und Sie können zwischen ihnen wechseln. Standardmäßig verwendet 3CX RFC5424 – das moderne, strukturiertere Format, das die meisten aktuellen SIEMs bevorzugen.

Wenn Ihr Sammler älter ist oder Sie ein Legacy-Format standardisieren, stellen Sie den Parameter auf RFC3164 ein, und 3CX formatiert ausgehende Nachrichten entsprechend. Als Referenz sehen Sie hier, wie die einzelnen Formate in der Praxis aussehen:

  • 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

In beiden Fällen ist <191> die Priorität der Nachricht, der Zeitstempel ist in UTC, mypbx.3cx-example.com ist der FQDN der Telefonanlage und das Anwendungs-Tag gibt die Quelle des Ereignisses an. Mögliche Anwendungs-Tags sind SyslogIntegrationTest, EventLog, AuditLog und Telemetry. Alles danach ist die Nutzlast der Nachricht.

Installation von Rsyslog unter Debian

  1. Stellen Sie eine SSH-Verbindung zu Ihrem Debian-Rechner her und führen Sie die folgenden Befehle aus, um rsyslog zu installieren und zu aktivieren:

sudo apt update

sudo apt install rsyslog

sudo systemctl enable rsyslog

sudo systemctl start rsyslog

  1. Bearbeiten Sie die Hauptkonfigurationsdatei von rsyslog:

nano /etc/rsyslog.conf

  1. Fügen Sie je nach dem von Ihnen unterstützen Protokoll (d. h. UDP/TCP) die folgenden Zeilen hinzu oder heben Sie die Auskommentierung auf und speichern Sie die Datei:

# 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. Starten Sie den rsyslog-Dienst neu, damit die Änderungen wirksam werden:

sudo systemctl restart rsyslog

Letztes Update
Dieses Dokument wurde zuletzt am 22. September 2026 aktualisiert.
https://www.3cx.de/docs/custom-syslog-server/