Protokollieren

MERLIC umfasst einen Protokollierungsmechanismus, der automatisch Protokollmeldungen in die entsprechenden Log-Dateien im Standardverzeichnis %LOCALAPPDATA%\MVTec\MERLIC\ schreibt. Auf die Log-Dateien können Sie im MERLIC Creator über den Menüeintrag „Hilfe → Log-Dateiverzeichnis öffnen„ zugreifen.

Die Log-Dateien verwenden die folgende Namenskonvention: <merlic_executable><YYYY-MM-DD>_<hh-mm-ss>_<ProcessID>_<Counter>.log

Platzhalter

Beschreibung

merlic‑executable

Der Name der ausführbaren Datei, von der die Log-Datei erstellt wurde. Die folgenden Komponenten von MERLIC erstellen eigene Log-Dateien:

  • MERLIC Creator, z. B.: merlic_creator_2021_12_14_08_19_23_7764_000.log

  • MERLIC Communicator, z. B.: merlic_communicator_2021_12_14_08_19_23_7764_000.log

  • MERLIC RTE, z. B.: merlic_rte_2021_12_14_08_19_23_7764_000.log

  • MERLIC RTE Setup, z. B.: merlic_rte_setup_2021_12_14_08_19_23_7764_000.log

Nicht alle MERLIC-Komponenten erstellen eine eigene Log-Datei, z. B. der MERLIC Designer. Weitere Informationen finden Sie im Abschnitt Sonderfälle bei der Protokollierung.

YYYY

Jahr

MM

Monat

DD

Tag

hh

Stunde

mm

Minute

ss

Sekunde

ProcessID

Windows-Prozess-ID der jeweiligen MERLIC-Instanz

Counter

Zähler der Log-Datei. Dieser wird immer dann erhöht, wenn MERLIC die Protokollierung in einer neuen Log-Datei beginnt, d. h. wenn die Log-Datei die maximale Größe überschreitet, die in „LogFileSizeInBytes“ festgelegt wurde. Bei jedem Start einer MERLIC-Instanz wird der Zähler auf 0 zurückgesetzt.
Sonderfälle bei der Protokollierung

Es gibt einige Sonderfälle bei MERLIC-Komponenten, die keine eigenen Log-Dateien erstellen:

  • Benutzeraktionen und Meldungen im MERLIC Designer werden in der Log-Datei merlic_creator_*.log aufgezeichnet.

  • Abhängig von der ausführbaren Datei, mit der das MERLIC Frontend gestartet wurde, werden Benutzeraktionen und Nachrichten in der Log-Datei merlic_rte_*.log oder in der Log-Datei merlic_creator_*.log aufgezeichnet.

  • Derzeit werden für das MERLIC Runtime Environment Setup (MERLIC RTE Setup) nur grundlegende Informationen protokolliert, d. h. Informationen zu Version, Lizenz und Programmstart. Diese Informationen befinden sich in der Log-Datei merlic_rte_setup_*.log. Die verschiedenen Komponenten des MERLIC RTE Setups verwenden jedoch jeweils eigene Protokollierungsregeln:

    • Abhängig von der ausführbaren Datei, mit der der Image Source Manager gestartet wurde, werden Aktionen in der Log-Datei merlic_rte_*.log oder in der Log-Datei merlic_creator_*.log aufgezeichnet.

    • Benutzeraktionen und Meldungen in der MERLIC RTE Setup-Komponente „Kommunikation“ werden in der Log-Datei merlic_communicator_*.log protokolliert.

    • Die MERLIC RTE Setup-Komponenten „Recipe“ und „I/O“ werden derzeit nicht protokolliert.

Protokollierung konfigurieren

Wenn Sie die Protokollierung konfigurieren möchten, um z. B. einen bestimmten Speicherort oder die Größe für die Log-Datei festzulegen, können Sie Ihre Einstellungen über „Bearbeiten → Einstellungen → Allgemein„ festlegen.

Log-Option

Beschreibung

Minimale Log-Ebene

Diese Eigenschaft definiert die verwendete Log-Ebene. Bei der Protokollierung von Meldungen einer bestimmten Ebene werden im Allgemeinen auch alle Meldungen von schwerwiegenderen Ebenen protokolliert. Die folgenden Log-Ebenen sind verfügbar:

  • Keine: Es werden keine Meldungen protokolliert.
  • Kritisch: Es werden nur kritische Meldungen protokolliert, d. h. Meldungen, die zum Absturz von MERLIC führen.
  • Fehler: Es werden nur Meldungen mit dem Schweregrad „Kritisch“ und „Fehler“ protokolliert, z. B. Fehlermeldungen von MERLIC-Tools.
  • Warnung: Es werden Meldungen mit dem Schweregrad „Kritisch“, „Fehler“ und „Warnung“ protokolliert, z. B. Meldungen, die auf ein Problem in einem Tool hinweisen.
  • Info: Es werden Meldungen mit dem Schweregrad „Kritisch“, „Fehler“, „Warnung“ und „Info“ protokolliert, d. h. Meldungen für allgemeine unkritische Informationen.
  • Trace: Es werden Meldungen mit dem Schweregrad „Kritisch“, „Fehler“, „Warnung“, „Info“ und „Trace“ protokolliert, d. h. Meldungen mit ausführlichen Informationen, die u. U. für die Erkennung des Kontexts von Warn- oder Fehlermeldungen nützlich sind.

Pfad der Log-Datei

Diese Eigenschaft definiert den Pfad zum Verzeichnis, in dem die Log-Datei gespeichert wird. Wählen Sie den Speicherort der Log-Dateien über die Schaltfläche aus.

Maximale Anzahl von Log-Dateien

Diese Eigenschaft legt die Anzahl von zuletzt erstellten Log-Dateien fest, die während der Ausführung von MERLIC im Log-Datei-Verzeichnis beibehalten werden, wenn eine Log-Datei die konfigurierte maximale Größe überschreitet. Log-Dateien werden beginnend mit der ältesten Datei gelöscht.

Wenn keine der Log-Dateien die konfigurierte maximale Größe überschreitet, wird die Anzahl von Log-Dateien im Log-Ordner nicht begrenzt. Daneben enthält der Log-Ordner Log-Dateien, die gerade erstellt werden.

Maximale Größe von Log-Dateien

Diese Eigenschaft definiert die maximale Größe der Log-Datei in Bytes. Wird die maximale Größe der Log-Datei erreicht, protokolliert MERLIC die neuen Meldungen in einer neuen Datei.

Minimaler Wert: 1.048.576 = 1 Megabyte

Weitere Informationen zu den Protokollierungsoptionen finden Sie unter Die .ini-Datei von MERLIC.

Informationen für MERLIC mit Prozessintegration protokollieren

Wenn Sie den Prozessintegrationsmodus von MERLIC verwenden und den vollständigen Datenaustausch zwischen der SPS und MERLIC prüfen möchten, können Sie die Protokollierungseinstellungen entsprechend konfigurieren. Legen Sie die Eigenschaft „Threshold“ auf „info“ fest, damit der Datenaustausch über die Protokolle FromMerlicProtocol und FromPLCProtocol ebenfalls in die Log-Dateien geschrieben wird. Einstellungen unter 1 MB werden ignoriert. Die Standardeinstellung für die maximale Dateigröße beträgt 10 MB.

Weitere Informationen zur Prozessintegration mit MERLIC finden Sie unter MERLIC-Prozessintegration.

Informationen für den MERLIC Communicator protokollieren

Die Einstellungen für die Log-Datei des MERLIC Communicators können in der Datei „Communicator.ini“ festgelegt werden.

Weitere Informationen finden Sie unter Die .ini-Datei für den Communicator im MERLIC Communicator-Handbuch.

Informationen für den Support erfassen

Zum Lieferumfang von MERLIC gehört ein zusätzliches Programm, mit dem Informationen zur Hardware eines Systems erfasst werden können. Falls Probleme auftreten und Sie sich an Ihren zuständigen Vertriebspartner wenden müssen, um Hilfe zu erhalten, können Sie dieses Programm verwenden, um Hardwareinformationen für Ihr System zu erfassen. Das Programm erfasst Informationen zu den verfügbaren Kameras, Bildquellen-Konfigurationen (ISM-Konfigurationen), Log-Dateien und .ini-Dateien auf Ihrem System. Diese Informationen helfen dem Supportteam dabei, schneller eine Lösung für Ihr Problem zu finden.

Gehen Sie folgendermaßen vor, um die Informationen zu erfassen:

  1. Öffnen Sie das Windows-Startmenü.
  2. Navigieren Sie zum Ordner „MVTec MERLIC 5.6“ und klicken Sie auf den Menüeintrag „MERLIC 5.6 Collect Support Information“. Wenn das Programm startet, wird automatisch eine Eingabeaufforderung geöffnet, und das Programm beginnt mit der Erfassung der Informationen. Sobald das Programm damit fertig ist, wird die Eingabeaufforderung wieder geschlossen.
  3. Die Informationen werden in der ZIP-Datei „MERLIC_Support_Information.zip“ in dem Verzeichnis gespeichert, das in den MERLIC-Einstellungen, d. h. in der .ini-Datei, als Pfad der Log-Datei festgelegt ist. Standardmäßig wird der betreffende Speicherort automatisch im Datei-Explorer geöffnet. Öffnen Sie den Datei-Explorer und navigieren Sie zum Speicherort für den Pfad der Log-Datei, um auf die ZIP-Datei zuzugreifen, falls dies nicht der Fall ist.
  4. Stellen Sie die erzeugte ZIP-Datei Ihrem zuständigen Vertriebspartner zur Verfügung.