Logging

visionCATS provides many logging features designed for troubleshooting scenarios. visionCATS users typically get these log files, as described in the following sections. The troubleshooting itself is normally performed by CAMAG distributors, or by the CAMAG Service team.

Installer logs

As mentioned in Troubleshooting, users performing the installation of visionCATS can get installer logs at any time. The logs consist in a ZIP file containing files copied from the Windows Temp folder (%temp% special name, usually corresponding to C:Users<userName>AppDataLocalTemp):

  • The installer log files of visionCATS itself, prefixed by visionCATS_

  • Other installation log files of related software installed along with visionCATS, such as SQL Server or the .NET Framework

  • Additional installation log files of SQL Server are also copied from the SQL Server installation folder, for advanced troubleshooting scenarios

visionCATS logs available

A visionCATS installation consists in:

  • A Server installation, whose log files are located in the log sub-folder of the installation folder:

    • The server windows service: log files begin with PlatypusServerLog.xml

    • The backup tool: log files begin with PlatypusBackupLog.xml

  • A set of Clients installations, for each of these:

    • The Client application: log files begin with PlatypusLog.xml in the %APPDATA%CAMAGvisionCATSlog folder of each Windows user using the software.

  • A set of HPTLC Instrument Services installations, for each of these, log files are located in the log sub-folder of the installation folder:

    • The HPTLC Instrument Service Windows Service : log files begin with PlatypusInstrumentServiceLog.xml

  • A set of HPTLC PRO Instrument Services installations, for each of these, log files are located in the log sub-folder of the installation folder:

    • The HPTLC Instrument Service Windows Service : log files begin with PlatypusInstrumentProServiceLog.xml

    • The HPTLC PRO Maintenance Tool application : log files begin with InstrumentPROTool.xml

    • For each HPTLC PRO Module connected with the Synchronized logging feature activated : log files are XML files named with the type - serial number of the HPTLC PRO Module (see Properties tab)

  • Additionally, front office client logs files begin with MethodCollectionFrontOfficeLog.xml and are located in folder %APPDATA%CAMAGMethodCollectionFrontOfficelog

Note that the log folders mentioned above also contain additional files designed for advanced troubleshooting scenarios:

  • svclog files: sometimes interesting to troubleshooting communications issues between the different software components

  • Other files prefixed with UpdateAnalyse, UpdateMethods or UpdateComparison: generated when a database saving failure occurs.

The Get debug logs functionality

Instead of manually searching for log files in different folders, visionCATS provides a centralized Get debug logs functionality (see Properties) to get the most important log information in one single click and pack them in a ZIP file. The functionality is also available when a crash occurs:

../../_images/GetDebugLogsDuringCrash.png

Note that the ZIP file only contains the last log files, in order to prevent the file to be too large to be shared with the CAMAG Distributor/Service team, often by attaching it in an email. The ZIP file contains enough information to troubleshooting various issues:

  • The last logs of:

    • The Server and Backup tool

    • The HPTLC Instrument Services currently connected

    • The HPTLC PRO Instrument Services currently connected along with the log of their HPTLC PRO Modules and their HPTLC PRO Maintenance Tool

    • The Clients currently connected (only for the currently connected Windows user)

  • For each connected PC, a SysInfo.txt containing essential operating system information (main hardware components, ports, status of the Windows installation)

  • A Metadata.txt file containing essential data concerning the visionCATS installation (license, instruments, users, database information)

Provided that the ZIP file only contains log information from running and connected application components. Therefore, referring to visionCATS logs available is still necessary to get log files for failing applications / services manually.