Lasernet Environment Logging

Note

For Lasernet server logging information for Lasernet 10, refer to the Lasernet Developer 10 Guide.

Lasernet environments generate log messages that can help you monitor processing status, monitor the flow of forms through Lasernet, and detect errors.

Access Lasernet Environment Logs

There are three ways to read a Lasernet environment’s log messages:

• Use the Logs page of Manage.

• Use the Lasernet Monitor desktop application.

• Open the environment’s log file.

Read Lasernet Logs in Manage

The Logs page in Manage enables you to select a Lasernet environment and view its log messages.

You can search the log for text and download the log messages as a file.

Navigate to the Logs Page

In the Manage side menu, click Logs (see 1 in the image below). Use the environment list (2) to select which environment’s log to view.

Click Fetch Oldest (3) to load and see the oldest log messages available for the environment.

Click Fetch Newest (4) to see the newest created log messages.

Search the Log

You can use the simple search to look for text in the Message column and move between those occurrences.

Find All is a more complex search feature. You can find occurrences of data in multiple log columns. This feature produces a list of search results.

Simple Search

Enter search text in the Search logs box (see 1 in the image below), then press Return. Manage finds occurrences of that text in the Messages column. The search is not case-sensitive.

To navigate between occurrences, click Find Next and Find Prev (2). Manage selects the row that contains the next or previous occurrence.

Find All

This feature enables you to search for different data in specific columns of the log. For example, you can search for “form” in the Messages column and “file” in the Module column. The search results are displayed as a list. You can click items in the list to jump to particular occurrences in the log.

To use this feature, follow these steps:

1. On the Logs page, click the menu button (three vertical dots), then click Find All.

   

2. In the Find All window:

   1. In Message, Module, JobID, and PublicID, enter text to search for. The search results will contain all the text that you enter in this window.

   2. In Event Types, select which event types to search. If you do not select any, all event types are searched.

   3. Click Confirm.

   

3. The Find All pane displays search results. The search results satisfy all the criteria that you entered in the Find All window. Click a search result to view that log entry in the main log area.

   

Download the Log as a File

On the Logs page, click the menu button (three vertical dots), then click Download Logfile. Manage downloads a ZIP file that contain log data in LNLOG format.

Clear the Log

To clear the log data displayed in Manage, click the menu button (three vertical dots), then click Clear Logs. This action clears the Logs page in Manage; it does not affect the logging data held by the environment itself.

Lasernet Monitor

Lasernet Monitor is a desktop application that enables you to view an environment’s log data. To start Lasernet Monitor, click Lasernet 11 > Lasernet Monitor 11 or Lasernet Developer 11 > Lasernet Monitor 11 in the Windows Start menu.

At the prompt, enter credentials to log in to the selected Lasernet Config Server. Lasernet Monitor will start.

The main part of the window displays log messages. Use the Environment list in the top corner to select which environment to view log messages for.

For more information about Lasernet Monitor, see Lasernet Monitor Guide.

Log File

In addition to making log messages available in Lasernet Monitor, a Lasernet environment writes log messages to an .lnlog file.

The location of the log file is determined by the environment’s Server runtime data directory location (in Lasernet Service Manager). If this setting is blank, the default location is used: C:\ProgramData\Formpipe Software\Lasernet 11\Service\<environment name> (appropriately substitute <environment name>). Else the location specified by Server runtime data directory is used.

The log file name is Lasernet.<host name>.lnlog (appropriately substitute <host name>). This file contains the newest log messages.

In Manage (and the Lasernet Config web app), you can configure Max logfile size (in KB), Max backup logs (as number of files), and Maximum log age (in days) for an environment. When the file described above reaches the size specified by Max logfile size, it will be renamed to Lasernet.1.lnlog , and a new blank Lasernet.<host name>.lnlog file will be created. If a Lasernet.1.lnlog file already exists, it will be renamed to Lasernet.2.lnlog , and so on for any other existing log history files. The number of log history files maintained is determined by Max backup logs and Maximum log age.

Each Lasernet environment and pod transfers the log messages that it generates to the Config Server. A single combined log file is generated there. The Lasernet Monitor tool fetches this combined log; in that tool, the user can use the Environment list to filter the log messages.

Lasernet Environment Log Content

Lasernet environment logs can contain the following types of messages:

Specify Which Types of Message Are Included in a Lasernet Environment’s Log

You can specify which types of message are included in the log. To do this, follow these steps.

Manage

1. Sign in to Manage.

2. In the side menu, click System Configuration (see 1 in the image below).

3. On the Environments tab, click the tile (2) for the Lasernet environment that you want to configure.

   

4. In the Logger area (3) of the environment’s properties pane:

   1. Use the Log Entries list to select which type of message to include in the log. The message types are described in Lasernet Environment Log Content.

      Warning

      Only select Debug or Session for Lasernet environments that are used for development or testing purposes. These logging levels are not suitable for use on production Lasernet environments because they can reduce Lasernet’s processing speed and generate a very large number of message lines in the log file. Session log messages can also use a very large amount of server memory.

   2. Optional: If necessary, you can change the default values for Max logfile size (kb), Max backup logs, and Maximum log age (days).

      Note

      When the Lasernet environment’s current log file reaches the Max logfile size, Lasernet archives it and creates a new blank log file to write new log messages to. At this point, Lasernet will delete any archived log files that exceed Maximum log age or that cause the number of archived log files to exceed Max backup logs (oldest are deleted first).

5. Click Confirm.

Lasernet Config Web App