日志记录

MERLIC 提供了一种日志记录机制，可自动将日志消息写入默认目录 %LOCALAPPDATA%\MVTec\MERLIC\ 中的相应日志文件。要访问 MERLIC Creator 中的日志文件，您可以使用菜单项“帮助 → 打开日志文件目录”。

生成的日志文件采用以下命名约定：<merlic_executable><YYYY-MM-DD>_<hh-mm-ss>_<ProcessID>_<Counter>.log

占位符：

描述

merlic‑executable

创建日志文件的可执行文件的名称。MERLIC 的以下组件会分别创建日志文件：

  • MERLIC Creator，即 merlic_creator_2021_12_14_08_19_23_7764_000.log

  • MERLIC Communicator，即 merlic_communicator_2021_12_14_08_19_23_7764_000.log

  • MERLIC RTE，即 merlic_rte_2021_12_14_08_19_23_7764_000.log

  • MERLIC RTE Setup，即 merlic_rte_setup_2021_12_14_08_19_23_7764_000.log

并非所有 MERLIC 组件都会创建其自身的日志文件，如 MERLIC Designer。请参阅日志记录中的特殊类别部分以了解更多信息。

YYYY

年

MM

月

DD

天

hh

小时

mm

分

ss

秒

ProcessID

相应 MERLIC 实例的 Windows 进程 ID

Counter

日志文件计数器。当 MERLIC 开始记录到新的日志文件，即当日志文件超出在“LogFileSizeInBytes”中设置的最大大小时，计数就会增加。每次启动 MERLIC 时，计数器重置为 0。
日志记录中的特殊类别

对于不创建自身日志文件的 MERLIC 组件，有一些特殊情况：

  • MERLIC Designer 中的用户操作和消息记录在日志文件 merlic_creator_*.log 中。

  • 视用于启动 MERLIC Frontend 的可执行文件而定，用户操作和消息记录在日志文件 merlic_rte_*.log 或 merlic_creator_*.log 中。

  • 目前，仅记录 MERLIC Runtime Environment Setup (MERLIC RTE Setup) 的基本信息，即版本、许可和程序启动。这些信息可在日志文件 merlic_rte_setup_*.log 中找到。但是，MERLIC RTE Setup 的不同组件遵循其各自的日志记录原则：

    • 视用于启动 Image Source Manager 的可执行文件而定，操作记录在日志文件 merlic_rte_*.log 或 merlic_creator_*.log 中。

    • MERLIC RTE Setup 组件“通讯”中的用户操作和消息记录在日志文件 merlic_communicator_*.log 中。

    • MERLIC RTE Setup 组件“Recipe”和“I/O”当前不予记录。

配置日志记录

如果要配置日志记录（例如为日志文件定义具体位置或大小），可通过 编辑 → 设定 → 一般 来设置设定。

日志选项

描述

最小日志等级

此属性定义所使用的日志等级。通常情况下，记录指定等级的消息时，更严格等级的所有消息也将被记录。可用的日志等级如下：

  • 无：不记录消息。
  • 关键：仅记录关键消息，例如导致 MERLIC 崩溃的错误。
  • 错误：仅记录严重程度为“关键”和“错误”的消息，例如 MERLIC 工具的错误消息。
  • 警告：记录严重程度为“关键”、“错误”和“警告”的消息，例如指示工具出现问题的消息。
  • 信息：记录严重程度为“关键”、“错误”、“警告”和“信息”的消息（即一般性的非关键信息）。
  • 跟踪：记录严重程度为“关键”、“错误”、“警告”、“信息”和“跟踪”的消息，即包含可能有助于理解警告或错误消息情况的详细信息的消息。

日志文件路径

此属性定义日志文件存储目录的路径。使用 按钮选择日志文件的位置。

日志文件的最大数量

此属性定义 MERLIC 运行期间日志文件目录中保存的最近创建的日志文件数量，以防其中一个日志文件超过所配置的最大大小。从最早的日志文件开始删除。

如果日志文件均未超过所配置的最大大小，则日志文件夹中的日志文件数量不受限制。此外，日志文件夹还将包含当前正在创建的日志文件。

日志文件的最大大小

此属性定义日志文件的最大大小（以字节为单位）。当达到日志文件的大小达到最大值时，MERLIC 会开始将新消息记录到新文件中。

最小值：1 048 576 = 1 MB

有关日志选项的更多信息，请参阅主题MERLIC .ini 文件。

支持流程集成的 MERLIC 的日志记录信息

如果您使用 MERLIC 的流程集成模式并希望能够检查 PLC 与 MERLIC 之间的完整数据交换，则可以对日志记录设置进行相应配置。将属性“Threshold”设置为 “info”，便可确保同时将通过协议 FromMerlicProtocol 和 FromPLCProtocol 进行的数据交换写入日志文件。小于 1 MB 的设置会被忽略，最大文件尺寸的默认设置为 10 MB。

有关与 MERLIC 的流程集成的更多信息，请参阅 MERLIC 流程集成。

MERLIC Communicator 的日志信息

MERLIC Communicator 日志文件的设定可在“Communicator.ini”文件中设置。

有关更多信息，请参阅主题 MERLIC Communicator 手册中的 Communicator .ini 文件。

收集用于支持团队的信息

MERLIC 提供了一个附加程序，可用于收集系统的硬件信息。如果遇到问题，需要联系当地分销商寻求帮助，可以使用此程序收集系统的硬件信息。该程序会收集系统上的可用相机、图像源配置（ISM 配置）、日志文件和 .ini 文件的信息。这些信息有助于支持团队更快地为您的问题找到解决方案。

要收集信息，可以按以下步骤进行：

  1. 打开 Windows 开始菜单。
  2. 导航到“MVTec MERLIC 5.6”文件夹并单击“MERLIC 5.6 Collect Support Information”菜单项。启动该程序时，将自动打开命令提示符并开始收集信息。一旦该程序完成，命令提示符将再次关闭。
  3. 信息收集到 .zip 文件“MERLIC_Support_Information.zip”中，该文件位于 MERLIC 首选项（即 .ini 文件）中设置为日志文件路径的目录中。默认情况下，文件资源管理器会自动打开相应的位置。如果没有，请打开文件资源管理器并转到日志文件路径的位置以访问该 .zip 文件。
  4. 将生成的 .zip 文件提供给您当地的分销商。