System Logs

With System Logs, you can monitor all logs generated by the system. Logs are generated for all system errors, warnings, process messages, and user locks due to failed login attempts from known users. Each log entry includes the date and time, level, version, and log message. Server script logs also include the script.

Types of log entries

  • General system logs

  • Server script logs

  • HTTP request logs

General system and server script log entries

Levels of log entries

Info

Logs generated due to the success of the event to give some information

Warn

Logs generated due to warnings

Error

Logs generated due to the failure of events

Debug

Logs generated to enable debugging

Verbose

Logs generated due to complex events

Critical

Logs generated due to critical system errors

Silly

Logs each system call, action, variable, extra information, and so on. Silly level is recommended for troubleshooting.

Filter log entries

You can filter the log entries by date and time, status, message, script project, and script name.

View log entry details

You can view the log details by selecting the icon next to the Version column.

Download log files

You can download a log file for view or manipulation by selecting an individual log file and selecting Download. The downloaded log file is formatted in JSON.

Log file rotation

By default, log files are rotated on a daily basis, so that one file is displayed in the System Logs tool per day. To rotate multiple files on a daily basis, you can set the environment variable P9_MAX_LOG_FILE_SIZE to rotate log files when a capacity limit is reached, for example, 1m (1 MB), 1k (1 KB) or 1g (1 GB). A subsequent log file with appended number suffix is created on your system.

HTTP request call log entries

You can monitor HTTP request calls as log file entries.

Log file entries for HTTP request calls are rotated on a daily basis. At the top of the log file overview, total daily requests, total duration time of the daily HTTP request calls in seconds, and total errors of all daily HTTP request calls are displayed.

In the URL tab, a log overview of all HTTP request calls is displayed in descending order. In the Users tab, an overview of usernames is displayed in descending order.

The log overview contains the following log information:

  • Number of total HTTP request calls

  • Total duration of all HTTP request calls in milliseconds

  • Average duration of all HTTP request calls in milliseconds

  • Error in relation to the HTTP request calls

You have the following options to filter the log file entries more granularly for both the URL and Users tabs:

Search

Use the incremental search to search for log file entries according to a free-text search

URL Parameters

Select Show full URL to display full-length URLs in the overview. Select No Parameters in URL to show only URLs without parameters

Period

Select a time period (Last 15 Min, Last 30 Min, Last 1 Hour, Last 2 Hours) to display data according to the selected time period

URL Filter

Choose between Show all URL, to show all URLs according to the remaining selections, Exclude Neptune API, to show all APIs except for Neptune APIs, or Only Show Neptune API, to only show Neptune APIs

Download log files

To download log file entries, select either the URL or Users tab, filter according to your requirements, and select Download. If you select the URL tab, the log file to download contains monitoring data for the HTTP request calls. If you select the Users tab, the log file contains monitoring data with usernames.

Related topics