MicroMon
Einleitung
Was ist microMon
MicroMon ist ein universeller Monitor zur Darstellung diverser Logs, Erhebung von Statistiken und Beurteilung der korrekten Funktion diverser Server.
Wer entwickelt microMon
Der microMon wurde zu erst non Public von mir allein entwickelt. Vornehmlich nutzte Ich microMon zum Überwachen des Status meines MPCS. Nachdem mir einige Streamboardler ans Herz gelegt hatten das Programm zu veröffentlichen, tat ich das dann. Im Zuge vieler Feature Requests kamen immer mehr neue Funktionen hinzu. Irgendwann sprach mich der Streamboard User pattex an, ob er sich an der Entwicklung beteiligen könne. Der Vorteil lag auf der Hand (doppelte Manpower, frische Ideen und Lösungsansätze) sodaß ich recht schnell zusagte. Es wurde ein privates SVN aufgesetzt, mit Welchem wir nun arbeiten. Mit pattex hinzukommen wurde derart viel geändert, das wir uns für ein neues Major Release entschieden (2.0 aka Thunderstorm). Der Name ist Programm. Wie bei einem echten Thunderstorm kamen in der 2.0 von Revision zu Revision neue Features bzw. vielen alte Begrenzungen weg. Eigentlich hätte jede Revision fast ein Minor Release sein können.
Back to Topic:
Entwickler:
Alno, pattex (SB)
Unterstützung Mirrors/ Doku:
Deas, Schlappohr, holly22, Apollo (SB)
Unterstützung Software crypt (Delphi):
wonderdoc, rudirabbit (SB)
Gnadenlose Tester und Ideenlieferanten aus dem SB:
-=HSKc=-Robby, Token u.v.a
Was kann microMon
- Liveauswertung der Logdaten des mpcs mit Datenbankfunktionalität
- über Profile ist es möglich die Daten mehrerer Servern zu verwalten
- Logzeilen mit definiertem Inhalt können farbig unterlegt werden, für eine bessere Übersicht
- Logausgaben können nach definiertem Inhalt gefiltert werden, um bestimmte Events zu überwachen
- es werden Statistiken angelegt über z.B. Onlinezeiten der User und Nutzungszeiten der Kanäle uvm.
- Logausgaben anderer Komponenten können angezeigt werden, z.B. camd3 Syslog
Systemvoraussetzungen
MicroMon basiert auf dem .NET2.x Framework. Das Framework ist erhältlich für alle Windowsversionen ab W2K. Sollte .NET2.x Framework nicht installiert sein, bietet der Installer den Download an. Für die Speicherung der historischen Daten wird der sogenannte JET Treiber benötigt. Dieser sollte ab Windows XP standardmäßig vorhanden sein. Der Installer prüft auch das Vorhandensein des JET Treibers und bietet ggf. den Download an. NET2.x und auch der JET Treiber stehen kostenlos bei Microsoft zur Verfügung.
GUI
Aufteilung der Elemente
Statusfenster
Logfenster
Detailfenster
Setup
Profile
Außer wenigen globalen Einstellungen ("Misc Options Setup" --> "Einstellungen alle Profile"), werden die Einstellungen bzw. Daten in sogenannten Profilen gespeichert. Das default Profil hat den Namen "Standard", es wird bereits beim ersten Start des microMon angelegt. Sollen weitere Server mit dazugehörigen Logs von Camd3, Gbox, Mbox ... sowie visuelle Einstellungen abgespeichert werden, müssen weitere Profile angelegt werden. Dazu wird, nach dem Ändern der Einstellungen (Settings), der Button "Speichern unter" ("Save Profile As") betätigt und ein aussagekräftiger Name für das neue Profil eingegeben.
Für das Laden eines Profils beim Start des microMon gibt es 2 Möglichkeiten. Zum einen kann in den Einstellungen (Settings) unter "Misc Options Setup" die Option "Select Profile on Startup" gesetzt werden. Bei jedem Start des microMon wir nun eine Auswahl der Profile angezeigt. Des weiteren kann das Profil auch als Parameter an den microMon übergeben werden. Der Aufruf des microMon mit einem Profil erfolgt wie folgt.
C:\microMon\mpcs_microMon.exe /profile=<Profilname> !!! ohne Dateiendung *.mmp !!!
Die Angabe eines Profils als Parameter hat gegenüber dem gesetzten "Select Profile on Startup" Vorrang. Die Auswahl erscheint somit nicht.
Beim Laden eines Profils, werden auch die zum Profil gehörenden User aus der Userdatenbank (Clients.mmgp) geladen und angezeigt.
Ist ein Profil geladen, werden alle Änderungen der Einstellungen (Settings) und einige visuelle Einstellungen wieder in dieses Profil gespeichert.
Speicherort der Profile:
C:\Dokumente und Einstellungen\<WindowsUser>\Anwendungsdaten\microMon (XP) C:\Users\<WindowsUser>\AppData\Roaming\microMon (Vista)
Erklärung der Dateiendungen:
*.mmp - microMon Profile (Einzelprofile) *.mmgp - microMon global Profile (Profil für alle Instanzen)
Eine Besonderheit:
Clients.mmgp - hier sind alle clients gespeichert die irgendwann mal erfaßt wurden
MPCS Setup
Statusview Setup
bitte ergänzen
Logwindow Setup
Filterregel erstellen
Die Filterregeln beziehen sich auf die MPCS Logs. Mit regulären Ausdrücken (RegEx) kann hier nach Situationen im Log gefahndet werden. Mit "Hinzufügen" wird eine neue Regel erstellt. !!Achtung!! Wenn zwei oder mehr Regeln (Suchmuster) auf eine Logmessage zutreffen wird die letzte zutreffende Regel gewertet. Die programmtechnisch letzte zutreffende Regel ist Die, welche auch in der Liste (Setup) am tiefsten steht.
Name
Die Regel muß einen eindeutigen tragen. Bei mehreren gleichnamigen Regeln wird nur die erste Regel ausgeführt.
Suchmuster
In einem Eintrag können mehrere Suchmuster mit "|" (pipe) als logisch "oder" verknüpft werden.
anonymous|unknown|fake
Eine logische "und" Verknüpfung würde wie folgt aussehen
found.*reader
Natürlich kann man auch Beides verknüpfen
(not found|ignored|timeout|rejected).*reader
Reguläre Ausdrücke sind ein mächtiges und sehr flexibles Werkzeug zur Erkennung von Mustern in Zeichenketten. Damit stehen Euch alle Möglichkeiten offen.
Farben
Mit den beiden Farbfeldern werden Vordergrund- und Hintergrundfarbe der gefundenen Logmeldung eingestellt. Nach Speichern der Regel wird in der Übersicht die Regel in den gewählten Farben dargestellt.
Font
Unter Font kann die Schriftart der gefundenen Logmeldung eingestellt werden. Mit einem Doppelklick auf den Fontnamen öffnet sich der von Windows bekannten Font- Auswahl Dialog. Nach dem Speichern der Regel wird der Font auf das Übersichtsfenster oben übertragen. Mit "Reset Font" kann der Ursprungszustand wieder hergestellt werden. !!Achtung!! Die Logmeldungshöhe paßt sich nicht der Fontgröße an. Ein zu groß gewählter Font macht die Logmeldung unleserlich.
Action
Wenn eine, den Kriterien entsprechende, Logmeldung gefunden wird kann zusätzlich zur Formatierung auch eine Action ausgeführt werden. Die zur Verfügung stehenden Actions werden in der Auswahlbox angezeigt sobald "Action" angehakt wird. Die beiden Felder neben der Actionauswahl sind der Initial Count und der Wiederholungs Count. Dabei gelten folgende Regeln:
Initialcount=5 Action wird nach 5 maligem auftreten des Musters erstmalig ausgelöst Wiederholungscount=0 Action wird nicht wieder ausgelöst
Initialcount=5 Action wird nach 5 maligem auftreten des Musters erstmalig ausgelöst Wiederholungscount=10 Action wird danach aller 10 auftreten des Musters erneut ausgelöst
Filterregel entfernen
bitte füllen
NewCS Setup
bitte ergänzen
G/Mbox Trace Setup
Ein neues Trace wird mit "Add" hinzugefügt. Sobald ein Trace hinzugefügt ist, kann man im Config Fenster die einstellungen vornehmen.
- Name (frei wählbar aber unique - jeder Name darf nur einmal existieren)
- Description (Beschreibung - hat für das Trace keine Bedeutung)
- Port (Zahl zwischen 0 und 64000 - jeder Port darf nur einmal belegt werden)
- Logtyp (GBox, MBox - hat momentan keinen Einfluß auf das Programm kann aber intern später genutzt werden)
- Enabled (nur wenn ein Trace "enabled" ist wird ein Logregister dargestellt. So kann man selten genutzte Traces ausblenden ohne Sie zu löschen)
Mit "Save" wird das Trace gespeichert.
Löschen kann man ein Trace durch markierung in der Liste und Klick auf "Remove"
Der Name eines Trace kann nach dem Speichern nicht mehr geändert werden.
Chart Setup
Im Chart Setup kann festegelgt werden:
- Maximalwert der Y Achse
- Schrittweite der Y Achse
Watchdog
Watchdogs können das lokale System überwachen. Wenn ein Watchdog aktiv ist, wird das angegebene Programm überwacht und falls der Prozess nicht mehr läuft neu gestartet. Geplant ist auch hier noch die Verknüpfung mit Actions.
Dieses Setupfenster ist eigentlich selbsterklärend:
- SMTP Server -> Dein Mailserver
- Port -> Der SMTP Port Deines Mailservers
- Username -> Dein SMTP Username
- Passwort -> Dein SMTP Passwort
- Absenderadresse -> Deine Absender Email Adresse
Actions Setup
Action erstellen
Actions sind im MicroMon die "Handler" (Ausführer). Eine Action kann deffiniert werden als:
- Sound
- Macro
Mehrfachbelegung ist möglich. Z.B. kann ein Macro ausgeführt werden und gleichzeitige eine Mail versandt werden. Um eine Neue Action anzulegen einfach auf "Hinzufügen" klicken.
Action entfernen
Eine Action kann gelöscht werden indem Sie markiert wird und "Entfernen" geklickt wird. MicroMon überprüft dabei ob die Action in Verwendung ist. Ist die Action z.B. mit einer Log Regel verknüpft wird das Löschen abgebrochen und die erste Logregel, mit der die Action verknüpft, ist angezeigt. Die Verknüpfung muß erst aufgelöst werden.
blockieren
In dieses Feld kann eine Blockierungsdauer in Sekunden eingetragen werden. Diese Blockierung ist für den Fall gedacht, das ein Suchmuster plötzlich sehr oft gefunden gefunden wird und der Wiederholungscount beispielsweise alle 5 Sekunden eine Action auslöst. Ist diese Action eine Mail- Action würde alle 5 Sekunden eine Mail verschickt werden. Die Blockierung schützt davor. Wenn hier zum Beispiel eine 120 eingetragen wird, ist die Action 2 Minuten geblockt. Auch wenn die Action alle 5 Sekunden ausgelöst wird, wird sie nur alle 2 Minuten (120 Sekunden) ausgeführt.
Sound
Um mit der Action einen Sound abzuspielen, muß "Sound" angehakt sein. Mit einem Doppelklick auf das Feld für den Pfad wird ein Auswahldialog geöffnet. Wenn eine *.wav Datei ausgewählt ist, kann Diese mit dem Button Test abgespielt werden.
Um einer Action eine Mail zuzufügen, muß "Mail" angehakt werden. Mit einem Doppelklick auf das Betreff Feld öffnet sich das Mail Setup. Dort kann die Empfängeradresse, die Betreffzeile und der Text festgelegt werden. Zusätzlich besteht die Möglichkeit Logzeilen aus dem Hauptlog mitzusenden. Die Anzahl der Logzeilen wird als Anzahl von unten angegeben. Ein Wert von 50 liefert also die letzten 50 Logzeilen. Sollten Im Hauptlog weniger Logzeilen vorhanden sein als angegeben, werden alle vorhandenen Logzeilen geschickt.
Voraussetzung für den Mailversand sind korrekte Serverdaten im Setup "Mail"
Wenn der Mailassistent fertiggestellt ist, kann mit "Test" diese Mail ausgelöst werden.
Macro
bitte füllen
Macro Setup
bitte füllen
Macro erstellen
bitte füllen
Macro entfernen
bitte füllen
Telnet Macro
bitte füllen
Windows Macro
bitte füllen
Misc Options Setup
bitte vervollständigen
Changelog
Next Revision: Fix: cosmetic in Tab "Reader" (1cm space on Bottom removed) 2.0.0.585 Fix: GBox / MBox could not connect after disconnect - fixed in UDP core Fix: Exception on Telnettest if plink path not exist 2.0.0.580 Add: Cleanup for V1.n Settings in "Misc Options" Add: Ping timeout configurable in "Misc Options". Default 2000mS Chg: Moved Ping to a separate thread Chg: GBox / MBox setup section comletely restructured Chg: GBox / MBox logging moved to new UDP Core and new Logoutput Add: Help window with Wiki page (Thanks @ Streamboard) 2.0.0.559 Chg: Complete restructure of macro setup Add: Unlimited number of macros possible now Alert: Webinterface works not with the new macros -> commands disabled until solution found Add: Macros are avail in Action Setup Add: Logrules have a complete Fontsetup now (smaller Fonts maybe for Netbooks useful) Fix: Exception in set split containers (minimize to tray) Fix: Minimize to tray issues Fix: some code optimization - maybe fixing an invisible memleak Fix: Possible deadlock in syslog core Chg: Syslog/ camd3 Log moved to new Log output (less CPU Load) Chg: Some cosmetic in Setup form 2.0.0.527 Fix: NewCS Port causes Error if not numeric Fix: 120dpi windows setting support Add: Instant UDP Log Add: Block Action for n Seconds (especially for mail to avoid flood) Fix: Action repeatcount = 0 avoid repeat Add: Some grouping in Clientdetails/ Channel History Chg: mpcs.srvid will not longer overwritten while install if exist add: new translation of some controls to german 2.0.0.478 Fix: German Language was not displayed for some controls Fix: Removing of a Client works now Fix: Window Sizes with 120dpi 2.0.0.451 Fix: cache0 causes sometimes error Add: Some more translations Add: In all Log Windows you can now copy all entries to clipboard Fix: lookup of hostnames in clientview was sometimes unknown host 2.0.0.443 Fix: Custom Log works again Fix: Parsing of 0D05&FFFFFF (FFFFFF became ignored) Add: LogColor Font bold added Fix: On simulating log a nameles client could be created which raises an exeption on next start Add: the status of logwindows (play,pause,stop) is now saved Add: LogColors Count activated - shows how often a RegEx has matched Add: LogColors Context added to delete all counts Add: LogColors Action selector Add: Actions Config - Actions can become used in LogColors as Alerthandler Add: Mailsetup sender address Fix: Ping timout causes a hanging Stats refresh (I---- Messages) Ping get 3 Chances now Add: Partial Multilanguage Support (englisch,deutsch) not all is translated jet 2.0.0.356 Add: DB Path per profile configurable (Setup "Logsettings") Chg: Path config for default logpath moved to setup "Logsettings" Chg: Standardpath for DB is now Applicationdata in userspace (MS conform) Fix: Watchdog stats refresh now on activate tab (only on firing WD before) Add: Plink.exe Path configurable Add: Watchdog stats columnsize saved per profile Add: New User changeable field "EMail" per Clientinfo Chg: New Configuration for coloring the log. the old settings are lost. Fix: Problem with icon column in clientview fixed 2.0.0.325 Fix: Clientlist grows up on each save Chg: ClientInfo window - stats ordered by date descending Fix: Problem with database under 64bit os solved Add: the debuglevel can now be set with the contextmenue in the logwindows Chg: Reorganisation of the ClientInfo Window Add: New User changeable fields "Name" and "notice" per ClientInfo 2.0.0.300 Fix: Autoupdate now working with all client security settings Fix: Crash with command line parameters Chg: sleeping clients are shown in clientdetails as "inactive" Add: Watchdog Stats Refresh active Chg: Clientload per profile 2.0.0.282 Add: if an error ocurred while updating micromon, the errormessage now shows the filename of the updater Chg: client settings saved in extra file. Add: Additional Infos in show client info dialog Add: Zapping History in show client info dialog 2.0.0.271 Add: changelog added 2.0.0.265 Add: New Column in Clientview lastactive Add: New Column in Clientview clientaddress Add: New Column in Clientview maxtime Add: Column Channel ist now colored red when more than 10 seconds no ecm received Add: Column time is now colored if responsetime bad Add: Column maxtime is now colored if responsetime bad Add: you can now hide the column in Clientview by right clicking and go to Columns entry Fix: invalid ecm responses are now mapped to ignored to show them in column i in clientview Add: New Register Watchdog Fix: In Userconfig the Button to download is now enabled only if the connection is established Add: the toaster info to update the software is now clickable Add: the watchdog states can be changed with a new menuentry