Log Viewer

Overview

The log viewer is used to filter and display the logging messages. You can filter the logging messages by limiting the displayed messages to the restrictions specified on this page.

To view logs, select Filter settings and click the View Log link. A separate browser window displays the logs.

To download a diagnostics .zip file containing all logs for the selected servers, click Download Diagnostics File in the left-hand menu. This may take some time depending on the size of the diagnostics file.

The diagnostics file also contains all configuration files and message logs, as well as the debug logs (including the Access Point raw external and internal logs, raw proxy interchange log, form based log, and hyperlinks log).

By selecting Enable debug logging on the Manage General Logging Settings page, the debug logs are automatically enabled.

About Log Search

See below for detailed information on how to search the logs using special characters and quoted searches.

Label

Mandatory

Description

Log Type

 

When selected, the logging messages displayed in the log viewer are restricted to a certain type of log.

Available options are:

System Log

Audit Log

RADIUS Log

HTTP Log

Billing Log

Set to System log by default.

Servers

Yes

List of Display Names of the registered services in the PortWise network.

Logging messages displayed in the log viewer are restricted to selected servers.

One, several, or all servers can be selected.

Set to All servers by default.

Search Criteria

 

Search string used to trace specific log events such as user activity through selected servers for example.

Searches are not case sensitive and the search criteria can consist of several words.

Example:

logon and userA

Both examples will display all log entries containing the words logon and userA.

Note that a search can be quite time consuming if there are a great amount of logs to filter.

For an OR search, use the special word ‘or’. OR operations have precedence over AND operations: “a or b and c or d” is equal to “(a or b) and (c or d)”.

In Digital Access, debug information is written to its own file: debug.log. This file is not centrally logged, it is only available on the services separately. Each service has two log files using max 50 MB, these files are rotated and old debug information is deleted.

A consequence of this is that debug information is not available in the Log Viewer. The system log in the Log Viewer only contains the levels INFO, WARNING, and FATAL.

Example

Description

fatal or warning

Displays all entries with the FATAL or WARNING severity levels.

fatal or warning and sql

Displays all entries with the FATAL or WARNING severity levels containing the word SQL.

Negations can be obtained using the minus sign ‘-‘.

Example

Description

-info

Displays all entries with all severity levels except the INFO level, consequently only in FATAL and WARNING.

fatal or warning and -sql

Displays all entries with the FATAL and WARNING levels, except for SQL messages.

The wildcard characters ‘*’ and ‘?’ are allowed. * signifies any number of characters, and ? signifies exactly one character.

Example

Description

abc*def

Displays all lines where the text "abc" can be found before the text "def".

abc?def

Displays all lines where the text "abc" can be found, followed by exactly one character, and then followed by the text "def".

Quoted searches can be used to search for whole sentences or for the wildcards characters.

Example

Description

fatal or warning -lcp -"tc5 system"

Displays all entries that have the FATAL or WARNING severity levels, but does not contain any LCP messages or the string "TC5 system".

" info "

Displays lines with the string "info" with spaces on each side (as a separate word).