3CX-Telefonanlage

Der Check 3CX-Telefonanlage überwacht eine 3CX-V20-Telefonanlage über die offizielle Configuration API. Er läuft standardmäßig alle 5 Minuten und prüft Systemzustand, Lizenz, TLS-Zertifikat, Backups, Updates und Gesprächskapazität.

Voraussetzungen

• Eine 3CX-API-Integration mit Zugriff auf die 3CX Configuration API. Wenn du Nebenstellen von der Registrierungswarnung ausnimmst, braucht die Integration zusätzlich Zugriff auf Users.
• Ein Gerät, das die 3CX-Anlage per HTTPS erreicht.

Schritte

1. Erstelle in 3CX unter Admin > Integrationen > API eine Integration mit Zugriff auf die 3CX Configuration API. Kopiere den einmalig angezeigten Schlüssel.
2. Füge den Check 3CX-Telefonanlage auf einem Gerät hinzu, das die 3CX-Anlage per HTTPS erreicht.
3. Gib unter 3CX-Host den FQDN oder die IP-Adresse ohne Schema und Port ein. HTTPS-Port ist standardmäßig 443; ältere oder angepasste Installationen verwenden eventuell 5001.
4. Trage API-Client-ID und API-Schlüssel ein und speichere.

Zur Zuweisung und den benötigten Berechtigungen siehe Checks mit Konfigurationspaketen zuweisen.

Einstellungen

Alle Schwellen greifen bereits bei Gleichheit: Lizenz und Zertifikat, sobald die verbleibenden Tage den Wert erreichen oder unterschreiten, Backup-Alter und Gesprächskapazität, sobald sie ihn erreichen. Gibst du Warn- und Kritisch-Wert vertauscht ein, tauscht der Check sie vor der Auswertung.

Warnungen für Nebenstellen anpassen

Wenn einzelne Nebenstellen absichtlich nicht registriert sind, kannst du deren Registrierungswarnungen ausnehmen, ohne die übrige Anlage weniger streng zu überwachen.

1. Lass Bei nicht registrierten Nebenstellen warnen eingeschaltet. Die Option ist standardmäßig aktiv.
2. Trage unter Ignorierte Nebenstellennummern die genauen Nummern ein, beispielsweise 0100 und 200. Führende Nullen zählen: 100 ist nicht dieselbe Nebenstelle wie 0100. Die Liste ist standardmäßig leer.
3. Stelle sicher, dass die 3CX-API-Integration Zugriff auf Users hat. Diesen zusätzlichen Zugriff benötigt der Check, sobald du Ausnahmen verwendest.

Um sämtliche Registrierungswarnungen für Nebenstellen abzuschalten, deaktiviere Bei nicht registrierten Nebenstellen warnen. Beide Einstellungen betreffen nur diese Warnung. Die angezeigten Gesamtzahlen und die übrigen Prüfungen, etwa für Trunks, Telefone und Dienste, bleiben unverändert.

Falls der Check nach dem Eintragen von Ausnahmen einen Berechtigungsfehler meldet, prüfe den API-Zugriff auf Users. Eine fehlgeschlagene Abfrage wird als Fehler gemeldet; der Check behandelt sie nicht als erfolgreiche Ausnahme.

Ergebnisse

Ein erfolgreiches Ergebnis bedeutet, dass die aktivierten Prüfungen keine Probleme melden. Warnungen und kritische Ergebnisse nennen beispielsweise nicht registrierte Trunks oder Nebenstellen, gestoppte Dienste, fehlende oder alte Backups, eine inaktive Lizenz oder erreichte Gesprächskapazität. Ein Fehler weist dagegen auf Anmeldung, Berechtigungen, Erreichbarkeit oder Timeout hin.