System Ereignisanzeige

Beschreibung

Innerhalb des LocaPhone-Systems und seiner Komponenten gibt es verschiedene System-Dienste, die jeweils ein oder mehrere Log-Dateien als Ereignisanzeige führen. Die Log-Dateien sind gruppiert in Unterverzeichnissen, oder liegen als einzelne Log-Datei vor.

Logdateien in Verzeichnis /var/log/...

Auf Basis eines System-Dienstes (rsyslog) werden diese Log-Dateien nach Zeit entsprechend rotiert (logrotate), sodass diese nicht beliebig groß werden.

LocaPhone - locaphone.log

Systemweite Ereignisanzeige LocaPhone mit Meldungen je nach aktivem Log-Level; allgemeine Log-Datei des TK-Systems.

Übersicht Log-Level

Je nach aktivem Log-Level werden verschiedene Ereignis-Kategorien als Meldungen erfasst.

Übersicht der zu erwartenden Meldungen in den einzelnen Log-Level:

Konfiguration Log-Level

/***********************************************************
*    LOGGING
***********************************************************/

$LOG_TO      = 'file';              # 'file'|'syslog'
$LOG_LEVEL   = 'NOTICE';            # "FATAL"|"WARNING"|"NOTICE"|"DEBUG"

  # these settings affect only file logging:
//$LOG_FILE    = '/var/log/locaphone/locaphone.log';
$LOG_GMT     = false;               # use GMT or local time

  # these settings affect only logging to syslog:
$LOG_SYSLOG_FACILITY    = 'local5'; # 'local0'-'local7' | 'user'

Hinweise zu Log-Leveln

Ein Log-Level ist als Filter bzw. "Sieb" anzusehen. Je höher das Log-Level gesetzt wird, desto gröber wird die Ausgabe (wobei "FATAL" das feinste Sieb ist, und "DEBUG" kein Sieb hat). Wenn man also "DEBUG" auswählt, dann erhält man alle Systemmeldungen; wenn man NOTICE auswählt, erhält man alle Systemmeldungen außer denen der Kategorie "DEBUG".

Zum Log-Level ist anzumerken, das es keine Standartantwort auf die Frage "Welches Loglevel soll ich nehmen?" gibt. Wenn z.B. ein Fehler auftritt, kann es sinnvoll sein "DEBUG" auszuwählen, da man so an wertvolle Informationen kommen kann, um den Fehler einzugrenzen und zu beheben. Im Normalbetrieb ist "NOTICE" ein sinnvoller Wert, da man damit noch genau sehen kann, was das System macht. Wenn Fehler auftreten, lässt sich der Zustand des Systemes zum Zeitpunkt des Fehlers leicht überblicken. Wenn das System längere Zeit problemlos funktioniert, kann es sinnvoll sein, den Log-Level auf "WARNING" oder sogar "FATAL" zu setzen, da dies die Größe der Logdatei veringert.

Wirkliche Aufmerksamkeit sollte Log-Meldungen mit der Stufe "WARNING" oder "FATAL" gewidmet werden. Fehler, die diese Log-Meldungen verursachten, können den Betrieb des Systemes ernsthaft beeinträchtigen oder sogar zum Erliegen bringen! Falls SQL-Fehler geloggt werden sollten, deutet dies ggf. auf einen Programmfehler in LocaPhone hin. Bitte kontaktieren Sie in diesem Fall die LocaNet GmbH!

Oct 12 15:42:12 voipnode1 locaphone: inc/util#99: (debug) PHP: SQL error
     HY000 / mysql 1114 "The table ’cdr_tmp_060097’ is full" in query: CREATE
     TABLE ‘cdr_tmp_060097‘ TYPE=heap SELECT * FROM ‘ast_cdr‘ WHERE\\n\\t\\t(
     ‘calldate‘>=’2009-10-01 00:00:00’ AND \\n\\t‘calldate‘>=’2009-10-31
     23:59:59’ ) AND\\n\\t‘src‘ IN

System Dienst Call Completion - cc.log

Informationen zum Leistungsmerkmal "Rückruf bei besetzt" für interne Verbindungen.

Ereignisanzeige des Dienstes 'call completion'

System - syslog

Informationen zur Analyse von diversen Problemen des TK-Systems und des Betriebssystems.

Ereignisanzeige aller systemweiten Meldungen.

System Dienst MTA - mail.log

Informationen zum Versand von E-Mail, z.B. vom MTA postfix/sendmail.

Ereignisanzeige Mail Transfer Agent und zugehörige Meldungen.

^{Das System führt ebenfalls ein Fehler-Log unter /var/log/mail.err.}

System Webserver  - apache2

Informationen zu diversen Teil-Funktionen von LocaPhone.

Ereignisanzeige Provisionierung, Webinterface LocaPhone, XML-Menüs Endgeräte.

^{Das System führt ebenfalls ein Fehler-Log unter /var/log/apache2/error.log.}

Für die Gigaset-Unterstützung wird ein zusätzlicher 'virtual host' konfiguriert, der in ein separates log-file schreibt.

Ereignisanzeige Gigaset.

^{Das System führt ebenfalls ein Fehler-Log unter /var/log/apache2/error-gigaset.log.}

System Dienst Astbuttond - astbuttond.log

Informationen zum astbuttond und der geladenen Konfigurationsdatei (Standard: /etc/astbuttond.config).

Ereignisanzeige Funktionstasten und Displayausgabe Endgeräte, Funktionen TK-System.

Je nach aktivem Log-Level werden verschiedene Ereignis-Kategorien als Meldungen erfasst.

# Uncomment to change the default level of debugging information
#ASTBUTTOND_DEBUG="3"

Über die Kommandozeile oder im Startscript kann man den Debug-Level des Systemdienstes festlegen. Standard (keine Eingabe) ist '0'; es werden nur Informationen zum Start bzw. zum Programmabbruch ausgegeben.

java -jar /opt/astbuttond/bin/astbuttond.jar /etc/astbuttond.config <level>

System Vermittlungskern - Asterisk

Informationen zum funktionalen Kern sowie diversen Teil-Funktionen von LocaPhone.

Ereignisanzeige Systemkern Vermittlungsfunktionen

Ereignisanzeige Warteschlangen und Agenten

System Dienst LiveMon APE Server - locaphone-livemon-server-aped.log

Informationen zum LiveMonitor Serverdienst APE (Inhalte für Monitor Nebenstellen/Agenten/Warteschlangen und Konferenzsystem).

Ereignisanzeige Ajax Push Engine

System Datenbank - MySQL

Informationen zum Datenbank-Server des Systems.

Ereignisanzeige Fehler MySQL DB

System Dienst Faxserver

Informationen zum Betrieb des Faxservers.

Ereignisanzeige Zustellung Übertragungen

Ereignisanzeige Fax und t38modem

Abhängigkeiten

Keine.

Zusätzliche Informationen

Keine.