5.5 Logging

While performing tasks on your device, the Endpoint Agent generates messages to track its activity. Each message is assigned a severity level: information, warning, error, or debug.

The following sections contain more information:

5.5.1 Changing the Message Log Level

By default, your Endpoint Management administrator controls what types of messages are stored in the local message log file. If your administrator needs to troubleshoot a Endpoint Agent issue on your device, he or she might direct you to change the log level setting so that additional information is logged. Otherwise, you probably never need to change the level.

To change the log level:

  1. Click the Agent Tray Icon ZENworks icon in the system tray.

  2. In the left navigation pane, click Logging.

  3. In the Applied Log Level field, select one of the following options:

    • Use Global Setting: Uses the message log level listed in the Global Log Level field.

    • Error: Logs error messages only. Error messages are generated whenever the Endpoint Agent is unable to perform a requested task.

    • Errors, Warnings: Logs error and warning messages. Warning messages are generated whenever the Endpoint Agent encounters a problem that might result in failure of a task.

    • Errors, Warning, Info: Logs error, warning, and informational messages. Informational messages are generated whenever the Endpoint Agent performs a task to show that the normal process is taking place.

    • Errors, Warning, Info, Debug: Logs all available messages to enable debug tracing of a problem. This level significantly increases the log file size and should be used only under the direction of your administrator.

  4. Click Apply to apply the new severity level.

5.5.2 Clearing the Message Log File

Depending on how your Endpoint Management administrator has configured the log file backup option, the message log can become quite large. You can clear all messages from the current log file to free up disk space or to more easily view new messages.

To clear the log:

  1. Click the Agent Tray Icon ZENworks icon in the system tray.

  2. In the left navigation pane, click Logging.

  3. Click Clear Log.

5.5.3 Viewing the Message Log File

The local log file, EndpointAgent.log, is stored in the program files\OpenText\Endpoint Agent\logs\LocalStore\ directory on the root of the system drive (for example, C:\Program Files\OpenText\Endpoint Agent\logs\LocalStore\EndpointAgent.log).

To view the log file:

  1. Click the Agent Tray Icon ZENworks icon in the system tray.

  2. In the left navigation pane, click Logging.

  3. Click View Log.

Each entry in the file contains multiple fields. Each field begins with [and ends with]. For example, [ERROR]. The following table describes the fields.

Field Number

Example

Description

1

ERROR

The severity level. Possible values are ERROR, WARNING, INFORMATION, and DEBUG.

2

3/14/2007 4:21:35 PM

The date and time the message was generated.

5.5.4 Accessing the Backup Log Files

Backup log files are stored in the same directory as the current message log file. Each backup file is an incremented ZIP file (for example, EndpointAgent.log.1.zip and EndpointAgent.log.2.zip).

To access the backup log file:

  1. Click the Agent Tray Icon ZENworks icon in the system tray.

  2. In the left navigation pane, click Logging.

  3. Click Open Log Folder.