Handbuch - Log Mail Notification

Inhalt

  1. Einleitung
  2. Systemanforderungen
  3. Bezug und Lizenzierung
  4. Installation
  5. Konfiguration
  6. Bedienung
  7. Fehlerbehebung
  8. Updates
  9. Support & Kontakt

 

Einleitung

Log Mail Notification (LMN) ist ein Windows-Dienst zur zeitgesteuerten Überwachung von Logdateien. Bei Erkennung definierter Suchbegriffe in bis zu drei Logdateien versendet das System automatisch E-Mail-Benachrichtigungen. Die Konfiguration erfolgt flexibel über eine XML-Datei. LMN unterstützt sowohl interne als auch eigene SMTP-Server für den Versand. Die interne SMTP-Funktion ist in der Ultimate-Version nicht enthalten.

 

Systemanforderungen

Betriebssystem: Windows 11, Server 2019+
.NET Framework: 4.8 oder höher
512 MB RAM

Internet:

  • für SMTP erforderlich, Port 465/587
  • für Lizenz-Überprüfung und Aktivierung erforderlich, Port 443

Optional:

SMTP-Konto mit Zugangsdaten (für den eigenen E-Mail-Versand)

Hinweis:

Der Windows Dienst Log Mail Notification benötigt entsprechende Berechtigungen, um auf die zu überwachenden Logdateien zugreifen zu können und wird unter dem System-Kontext installiert.

 

Bezug und Lizenzierung

Log Mail Notification können Sie über unsere Webseite mit entsprechender Lizenz erwerben: https://www.logmailnotification.com. Hier finden Sie auch Tipps zur Anwendung des Programms.

Die Lizenz-Modelle stehen Ihnen für unterschiedliche Einsatzszenarien zur Verfügung, haben eine Laufzeit von einem Jahr und werden nicht automatisch verlängert. Hierbei handelt es sich um kein Abonnement. Vor Ablauf einer Lizenz werden Sie per E-Mail dazu informiert und entscheiden selbst, ob Sie erneut eine Lizenz erwerben möchten. Bei Single-Lizenzen kann die Computer-Aktivierung im Kundenbereich jederzeit freigegeben werden.

Eine Upgrade-Funktion unserer Lizenz-Modelle gibt es nicht. Bei Lizenz-technischen Fragen können Sie sich gerne an unseren Support (siehe Abschnitt Support & Kontakt) wenden.

Lizenz-Modelle

Log Mail Notification – Trial

  • Lizenz: 3 Tage
  • Abonnement: Nein
  • Betriebssystem: Windows
  • Hostsystem: Clients
  • Computer: StandAlone
  • Clients: 1
  • Framework: .NET 4.8
  • Mail SMTP: eigener, inklusiv
  • Updates: Nein
  • Sprache: DE, EN

 

Log Mail Notification – Standard

  • Lizenz: 1 Jahr
  • Abonnement: Nein
  • Betriebssystem: Windows
  • Hostsystem: Clients
  • Computer: StandAlone
  • Clients: 1
  • Framework: .NET 4.8
  • Mail SMTP: eigener, inklusiv
  • Updates: Ja
  • Sprache: DE, EN

 

Log Mail Notification – Professional

  • Lizenz: 1 Jahr
  • Abonnement: Nein
  • Betriebssystem: Windows
  • Hostsystem: Clients, Server
  • Computer: StandAlone, Domain
  • Clients: 1
  • Framework: .NET 4.8
  • Mail SMTP: eigener, inklusiv
  • Updates: Ja
  • Sprache: DE, EN

 

Log Mail Notification – Ultimate

  • Lizenz: 1 Jahr
  • Abonnement: Nein
  • Betriebssystem: Windows
  • Hostsystem: Clients, Server
  • Computer: StandAlone, Domain
  • Clients: unbegrenzt
  • Framework: .NET 4.8
  • Mail SMTP: eigener
  • Updates: Ja
  • Sprache: DE, EN

 

Aktuelle Lizenz-Informationen zum eingesetzten Programm erhalten Sie während der Laufzeit unter den Log-Meldungen von Log Mail Notification selbst.

 

Installation

Die Installation von Log Mail Notification ist einfach und flexibel. Das Setup unterstützt sowohl eine grafische Benutzeroberfläche (GUI) als auch eine Silent-Installation für automatisierte Deployments. Beide Varianten bieten denselben Funktionsumfang und sind für unterschiedliche Einsatzszenarien optimiert. Die Installations-Datei steht Ihnen nach dem Kauf von Log Mail Notification im Kundenbereich unserer Webseite zur Verfügung.

Hinweis:

Zu Installationen bei bestehender Vorinstallation wird die Programm-Konfiguration beim Setup automatisch übernommen. Update-Installationen erfolgen vollautomatisch, ebenso mit Konfigurations-Übernahme.

Für die Installation von Log Mail Notification stehen zwei Installations-Routinen zur Verfügung für deren Durchführung jeweils Administrations-Rechte benötigt werden.

1. Konventionelle Installation über das Setup-Programm (GUI)

Das Setup-Programm leitet Sie vollständig grafisch durch die Installation. Die Bereitstellung des Programms wird mit Standard-Werten durchgeführt. Unter neueren Windows-Versionen können Änderungen an Startmenüeinträgen (Name/Symbole) erst nach einer Ab‑/Anmeldung oder einem Neustart sichtbar werden.


2. Spezifische oder automatische Installation über die Console/PowerShell (Silent)

Silent-Installation (Unattended Setup)

Unterstützte Parameter

/VERYSILENT - Vollständig ohne Benutzeroberfläche (keine Dialoge)
/SILENT - Minimale Oberfläche (Fortschrittsanzeige), keine Interaktion
/SUPPRESSMSGBOXES - Unterdrückt alle Messageboxen (Fehlerdialoge etc.)
/NORESTART - Verhindert automatischen Neustart nach Installation
/RESTART - Erzwingt Neustart nach Installation
/DIR="Pfad" - Installationsverzeichnis festlegen
/GROUP="Name" - Startmenü-Ordner festlegen
/LOG="Pfad" - Installationsprotokoll schreiben

Beispiel: /DIR="C:\Program Files\Log Mail Notification"

Beispiele zur Silent-Installation von Log Mail Notification

LogMailNotification_X-X-X.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /LOG="C:\Temp\LMN_Setup.log"

LogMailNotification_X-X-X.exe /SILENT /DIR="D:\Tools\LogMailNotification" /GROUP="Log Mail Notification"

Hinweis:

Zu Installationen bei bestehender Vorinstallation wird die Programm-Konfiguration beim Setup automatisch übernommen. Update-Installationen erfolgen vollautomatisch, ebenso mit Konfigurations-Übernahme.

Der Windows-Dienst wird unter dem System-Kontext bereitgestellt, auf automatischen Start konfiguriert und gestartet. Nach der Installation steht eine Muster-Konfiguration zur Verfügung. Diese enthält unter anderem eine nicht funktionierende Beispiel Lizenz. Da die Lizenz nicht gültig ist, wird der Dienst wieder gestoppt. Die produktiven Konfigurationsmöglichkeiten von Log Mail Notification können Sie im Abschnitt Konfiguration einsehen.

 

Konfiguration

Um Log Mail Notification auf Ihre Bedürfnisse produktiv konfigurieren zu können, steht die Konfigurationsdatei LogMailNotification.config als XML-Datei unter dem Programmverzeichnis C:\Program Files\Log Mail Notification bereit. Zur Konfigurations-Vorlage wird die Datei Example_LogMailNotification.config ebenso im Programmverzeichnis bereitgestellt.

Die Konfigurations-Datei beinhaltet die nachfolgend genannten Einstellungsmöglichkeiten (XML-Segmente). Seit Version 1.3.x wurde die Logdatei-Konfiguration erweitert, sodass bis zu drei unterschiedliche Logdateien parallel überwacht werden können.

Empfohlene Vorgehensweise zur Konfiguration

  1. Zuerst Aktivierung (Serial) und Mail-Empfänger eintragen.
  2. Danach die Logdatei-Überwachung mit logfile1/logstring1 testen.
  3. Erst anschließend weitere Überwachungen mit logfile2/logstring2 und logfile3/logstring3 ergänzen.
  4. Zum Schluss SMTP-Modus festlegen (intern oder extern), Testmail aktivieren und Dienst neu starten.

Hinweis: Änderungen an der Konfigurationsdatei werden beim nächsten Dienststart wirksam. Prüfen Sie danach die Einträge in den Logdateien und im Eventlog unter Log Mail Notification.

Logdatei-Überwachung

<log>
  <logfile1>C:\Logs\app.log</logfile1>
  <logstring1>Error</logstring1>
  <logfile2>C:\Logs\web.log</logfile2>
  <logstring2>Critical</logstring2>
  <logfile3>C:\Logs\sec.log</logfile3>
  <logstring3>Failed login</logstring3>
  <casesensitiv>false</casesensitiv>
  <loglasttime>60</loglasttime>
</log>

❗ Pflichtangabe

Mit logfile1 und logstring1 definieren Sie die erste Logdatei-Überwachung. Optional können Sie mit logfile2/logstring2 sowie logfile3/logstring3 zwei weitere Überwachungen ergänzen. Damit können bis zu drei verschiedene Logdateien parallel überwacht werden.

Unter casesensitiv legen Sie fest, ob die Suche nach dem Suchbegriff groß-/kleinschreibungssensitiv erfolgt. loglasttime gibt das Zeitfenster in Minuten an, in dem Treffer berücksichtigt werden.

Leere oder unvollständige Einträge werden ignoriert.

Kompatibilität

Die Multi-Logdatei-Überwachung ist eine Erweiterung der bisherigen Konfiguration. Bestehende Installationen mit logfile/logstring bleiben weiterhin lauffähig. Neue Installationen sollten bevorzugt die erweiterte Struktur mit logfile1..3 und logstring1..3 verwenden.

Beispiel für eine kombinierte Erweiterung im Betrieb: zunächst nur logfile1/logstring1 produktiv setzen und weitere Überwachungen (2/3) bei Bedarf schrittweise ergänzen.

Zeitintervall der Abfrage

<timer>
  <timertime>60</timertime>
</timer>

❗ Pflichtangabe

Mit timertime unter der Konfigurations-Sektion timer legen Sie den Abfrage-Intervall für die Logdatei-Überwachung fest. Die Angabe erfolgt in Minuten, z. B. 60 und akzeptiert Werte zwischen 5 Minuten und 1440 Minuten (24 Stunden).

SMTP-Funktion (eigener Mail-Server)

<smtp>
  <smtpserver>smtp.example.com</smtpserver>
  <smtpport>465</smtpport>
  <smtpuser>Diese E-Mail-Adresse ist vor Spambots geschützt! Zur Anzeige muss JavaScript eingeschaltet sein.</smtpuser>
  <smtppassword>password</smtppassword>
  <smtppassencryption></smtppassencryption>
  <smtpencryption>SSL</smtpencryption>
</smtp>

✔️ Optional

Die unter der Konfigurations-Sektion smtp angegebenen Werte sind Beispieldaten. Für die Verwendung der internen SMTP-Funktion von Log Mail Notification können Sie die Beispieldaten so übernehmen oder die einzelnen Werte leer lassen. Damit werden E-Mails über den Mailserver von Log Mail Notification versandt. Die Nutzung ist je Jahres-Lizenz wie folgt eingeschränkt:

  • Log Mail Notification Trial: 30 E-Mails/3 Tage je Lizenz
  • Log Mail Notification Standard und Professional: 500 E-Mails/1 Jahr je Lizenz
  • Log Mail Notification Ultimate: keine Nutzung des internen SMTP, da die Computeranzahl nicht eingeschränkt ist.

Alle Versionen von Log Mail Notification lassen die Verwendung des E-Mail-Versands mit eigenem SMTP-Server zu. Die Konfiguration dazu können Sie den Beispieldaten entnehmen. Unter smtpencryption wählen Sie bitte entweder SSL oder TLS aus. Beachten Sie: Für SSL wird standardmäßig der Port 465 und für TLS der Port 587 genutzt. Welche Konfiguration für Sie relevant ist, erfahren Sie von Ihrem Mail-Provider.

SMTP-Passwort: Klartext oder verschlüsselt

  • smtppassencryption leer: smtppassword wird als Klartext gelesen.
  • smtppassencryption gesetzt: smtppassword wird als verschlüsselter Wert gelesen und beim Start entschlüsselt.

Für die Erzeugung eines kompatiblen verschlüsselten Passwortwertes wird SmtpPassEnc.exe mitgeliefert. Tragen Sie den erzeugten Wert unter smtppassword ein und setzen Sie smtppassencryption entsprechend.

Dasselbe Werkzeug kann auch zum Verschlüsseln des Proxy- und SOCKS-Passworts verwendet werden (siehe Abschnitt Proxy-Konfigurationsmöglichkeit, Flag passwordencryption).

Wenn die Entschlüsselung fehlschlägt, protokolliert Log Mail Notification einen Fehler in der Logdatei und verwendet kein gültiges SMTP-Passwort.

Empfohlene Testreihenfolge für SMTP

  1. Externe SMTP-Daten vollständig eintragen (Server, Port, Benutzer, Passwort, SSL/TLS).
  2. Optional Passwort verschlüsseln und smtppassencryption setzen.
  3. sendtestmaillmn=true aktivieren.
  4. Dienst neu starten und Testmail-Eintrag in der Logdatei prüfen.

Hinweis: Änderungen an der Konfigurationsdatei werden beim nächsten Dienststart wirksam. Prüfen Sie danach die Einträge in der Logdatei Log Mail Notification.

SMTP-Test für interne Funktion

  • Nach der Installation steht eine nicht funktionierende Beispiel-Konfiguration zur Verfügung.
  • Testen Sie die interne SMTP-Funktionalität mit folgender Konfiguration (so wird die .config ausgeliefert) oder lassen Sie die Werte leer:
<smtp>
    <smtpserver>smtp.example.com</smtpserver>
    <smtpport>123</smtpport>
    <smtpuser>Diese E-Mail-Adresse ist vor Spambots geschützt! Zur Anzeige muss JavaScript eingeschaltet sein.</smtpuser>
    <smtppassword>password</smtppassword>
    <smtppassencryption>false</smtppassencryption>
    <smtpencryption>SSL/TLS</smtpencryption>
</smtp>


Mail-Empfänger der Benachrichtigungen

<mail>
  <mailtoemail>Diese E-Mail-Adresse ist vor Spambots geschützt! Zur Anzeige muss JavaScript eingeschaltet sein.</mailtoemail>
  <mailtoname>Example User</mailtoname>
  <mailccemail></mailccemail>
  <mailccname></mailccname>
</mail>

❗ Pflichtangabe

Unter mail definieren Sie den Hauptempfänger und optional einen CC-Empfänger.

Versand der Test-E-Mail

<testmail>
  <sendtestmaillmn>true</sendtestmaillmn>
  <sendtestmailsmtp>true</sendtestmailsmtp>
</testmail>

❗ Pflichtangabe

sendtestmaillmn steuert die monatliche Testmail, sendtestmailsmtp die SMTP-Starttestmail.

Allgemeiner Kontakt (Organisation in der E-Mail)

<contact>
  <contactorganisation>Example Contact Organisation</contactorganisation>
  <contactperson>Example Contact Person</contactperson>
  <contactphone>+12 3456 7890</contactphone>
  <contactmail>Diese E-Mail-Adresse ist vor Spambots geschützt! Zur Anzeige muss JavaScript eingeschaltet sein.</contactmail>
</contact>

❗ Pflichtangabe

Die Angaben werden als Kontaktblock in E-Mails verwendet.

Aktivierung des Programms / Lizenz

<activation>
  <serial>YOUR-SERIAL-HERE</serial>
</activation>

❗ Pflichtangabe

Unter serial muss der gültige Lizenzschlüssel exakt hinterlegt werden.

Spezifische Einstellungen

<settings>
  <language>de</language>
  <beta>false</beta>
</settings>

❗ Pflichtangabe

language steuert die Sprachausgabe, beta die Freigabe von Beta-Updates.

Proxy-Konfigurationsmöglichkeit

<proxy>
  <enabled>false</enabled>
  <useSystem>true</useSystem>
  <url>http://proxy.example.local:8080</url>
  <username></username>
  <password></password>
  <passwordencryption>false</passwordencryption>
  <bypassOnLocal>true</bypassOnLocal>
  <noProxy>*.intranet.local;10.0.0.0/8</noProxy>
  <socks>
    <enabled>false</enabled>
    <type>SOCKS5</type>
    <host>proxy.example.local</host>
    <port>1080</port>
    <username></username>
    <password></password>
    <passwordencryption>false</passwordencryption>
  </socks>
</proxy>

❗ Pflichtangabe

Damit steuern Sie direkte Verbindung, Systemproxy oder explizite Proxy-/SOCKS-Nutzung.

Auch das Proxy- und SOCKS-Passwort kann verschlüsselt hinterlegt werden. Setzen Sie dazu im jeweiligen Abschnitt passwordencryption auf true und tragen Sie unter password den mit SmtpPassEnc.exe erzeugten Wert ein. Bei false (oder fehlendem Eintrag) wird das Passwort als Klartext gelesen. Die Flags gelten getrennt für SMTP, Proxy und SOCKS.

Bedienung und weitere Tools

Unter Start / Programm / Log Mail Notification stehen Ihnen weitere Features zur Verfügung:

  • LogTest.exe – Testprogramm für Log Mail Notification
  • Links zu Log Mail Notification: Release Notes, Webseite, Support
  • Dokumente: Handbuch, Lizenz
  • Tools:
    • Service Configuration (Konfigurations-Datei öffnen)
    • Service Configuration Example (Beispiel-Konfigurations-Datei öffnen)
    • Service Control (Steuerung des Windows-Diensts über cmd)

Fehlerbehebung

Zur Fehleranalyse von Log Mail Notification können Sie die programmeigenen Logdateien und Eventlog-Einträge nutzen. Diese sind in der Ereignisanzeige unter Anwendungs- und Dienstprotokolle / Log Mail Notification sichtbar. Die Logs bieten Ihnen eine Übersicht über folgende Programmabläufe:

  • Lizenzierung
  • Aktivierung
  • Konfiguration
  • Update
  • Proxy-Nutzung
  • E-Mail-Kontingent (Trial, Standard und Professional bei SMTP intern)
  • Logdatei-Überwachungen (bis zu 3 konfigurierbare Logdateien)
  • Lizenzablauf-Hinweis (Info-E-Mail mit Tageslimit)

Bei der Logdatei-Überwachung prüfen Sie bitte insbesondere die Einträge zu logfile1/logstring1, optional logfile2/logstring2 sowie logfile3/logstring3 in der Konfigurationsdatei.

Diese Informationen sind sehr hilfreich und dienen auch der Support-Unterstützung.

Wichtige Event-IDs

Event-IDBedeutung
1001 Windows-Dienst gestartet
1002 Konfiguration angewandt
1011 SMTP-Nutzung (intern/extern)
1012 Interner SMTP-Zähler: x von y
1013 Interner SMTP gesperrt (Kontingent erreicht)
1014 Logdatei-Überwachung erfolgreich durchgeführt
2001 Aktivierung erfolgreich
2002 Lizenz gültig
3001 Warnung / erneuter Versuch
3002 Logdatei-Problem (nicht gefunden, Zugriff verweigert)
7001-7004 Fehler (allgemein, Lizenz, Aktivierung, CSRF-Token)

 

Updates

Zu jedem Start des Windows-Dienstes Log Mail Notification wird die Abfrage nach Updates durchgeführt. Falls ein Update zur Verfügung steht, wird dies automatisch heruntergeladen und im Hintergrund installiert. Hierbei werden die bereits bestehenden Konfigurationseinstellungen übernommen und der Dienst nach dem Update wieder gestartet. Diese Vorgehensweise wird Ihnen als Benutzer nicht auffallen. Falls Sie Interesse am Verlauf oder der aktuell installierten Version haben, können Sie dies in der Ereignisanzeige unter Anwendungs- und Dienstprotokolle / Log Mail Notification einsehen.

Die aktuellen Informationen zu den Release Notes und den Änderungen von Log Mail Notification können Sie auf unserer Webseite einsehen: https://www.logmailnotification.com/de/software/releasenotes

Support & Kontakt

Unser Support steht Ihnen für folgende Themen zu Log Mail Notification per E-Mail oder Ticket-System zur Verfügung:

  • Allgemein
  • Entwicklung
  • Lizenzierung
  • Feedback

Diesen erreichen Sie unter:

Webseite
www.logmailnotification.com

Support (Anmeldung erforderlich)
www.logmailnotification.com/de/konto/support

Falls Sie uns Ihr Feedback hinterlassen möchten oder Verbesserungsvorschläge für uns haben, können Sie uns gerne über die Seite Support informieren. Wir würden uns auch über Ihre Bewertung oder einen Kommentar zur gekauften Version freuen.