NetVault 13.0.3 - Administration Guide for Managed Service Providers

Viewing log messages

You can view the log messages from the View Logs page. From this page, you can perform various log-related tasks, like download or export log messages, set log events, or purge log messages.

MSP administrator, tenant administrator, and tenant user can view job messages of the authorized client machines.

To view the log messages:

In the Navigation pane, click View Logs.

On the View Logs page, you can view the log messages generated by various processes.

Figure 26. View Logs page

The table displays the following information:

•

Severity: Severity level of the message.

Log messages are classified into the following severity levels: Background messages, Information messages, Job messages, Warning messages, Error messages, and Severe error messages.

•

Date: Sate and time when the log was generated.

•

Job ID: Job identification number.

•

Class: Type of operation that generated the logs.

Log classes include the following: System, Schedule, Jobs, Media, Database, Plugins, and UI.

•

Client: Name of the client for which the log was generated.

•

Message: Detailed log message or description.

The following table provides a brief description of the log severity levels.

Table 76. Log severity levels
Icon	Severity level	Description
	Background	General log messages.
	Information	Log messages related to media, scheduler, and system activities.
	Job message	Log messages related to backup, restore, and report jobs.
	Warning	Problems that might not have caused a job to fail.
	Error	Problems that might have caused a job to fail.
	Severe error	Critical problems that might have caused an operation to fail.


	NOTE: The icons for some log messages can contain an exclamation mark (for example, , , and others). This mark indicates that you can open the message to view the log context information. To view the context information, click anywhere in the Severity column. Alternatively, select the message, and click More Info. The dialog box that appears can include data transfer details, execution scripts, or other information. After reviewing the details, click OK to close the dialog box. Setting the 'Display Level' to a particular severity level shows log messages for the selected severity and higher.

By default, the table is sorted by Date (newest to oldest).

You can sort the table by one or more columns, as required. For more information, see Sorting records in NetVault WebUI.

To set the filter options (For more information on table filter options for View Logs page, see Table 8), view the page size setting, column sort order, applied filters in the table, export the records, or edit table settings, click the icons at the lower- right corner of the table.

For more information, see Customizing tables in NetVault WebUI.

You can use the Search option to filter the table data and quickly find entries that contain the specified string in any column values. You can also include wildcards (“?” or “*”) in the search filter string. Type the search text into the box and click the tick icon or press Enter.

You can use the Display Level option to filter the messages based on their severity level. When you specify the severity level, the messages at that level and higher are displayed on the View Logs page.

By default, Display Level is set to Job Messages. With this setting, you can view Job Messages, Warnings, Errors, and Severe errors on the page. To specify the minimum severity level for messages that are displayed, select the level in the Display Level list.

The View Logs page loads a maximum of 10,000 records initially. The total number of records fetched is displayed at the lower-right corner of the table.

You can click Load more to load the next set of records, if available. Each load action fetches a maximum of 10,000 records. This button is disabled if there are no more records to load.

To stop or resume live updates, click the Pause or Resume Live Updates button.

To perform a log-related task, click the corresponding button in the Operations pane. Alternatively, click a link in the Navigation pane to open a different page.

Downloading logs

When investigating a reported problem, Quest Technical Support might request you to provide the log dump from the NetVault Server. You can generate the dump file by using the Download or Export method available on the View Logs page.

The Download method creates dump files on the local machine where the WebUI is running. This method is useful if you are accessing the server from a remote machine. The Export method creates the file on the NetVault Server. For more information about this method, see Exporting logs.

The supported dump formats are text, binary, and database table dump. By default, the dump file includes all current logs. You can use the filter options to download log entries that meet the specified criteria. For instance, you can set filter options to display log entries for a specific period or a specific job ID number, and then download these entries to a dump file.

To download logs:

In the Navigation pane, click View Logs.

Click Download, and in the Confirm Download Logs dialog box, select the dump format:

•

Binary Log: Select this option to export the logs to a binary file (“.nlg”).

•

Text Log: Select this option to export the logs to a text file.

•

Database Table Dump: Select this option to export the logs to a PostgreSQL dump (pg_dump) file.


	NOTE: When you want to provide the log dump file to Quest Technical Support, use the Binary Log (.nlg) format.

Click Download, and in the confirmation dialog box, click OK.

In the File Download dialog box, select the Save option, and specify the location, if necessary. Make sure that you do not navigate away from the page until the browser starts downloading the file.

After the browser finishes downloading the file, you can find a compressed file in the download location.

Exporting logs

The Download method creates dump files on the local machine where the WebUI is running. This method is useful if you are accessing the server from a remote machine. For more information about this method, see Downloading logs. The Export method creates the file on the NetVault Server.

The supported dump formats are text, binary, and database table dump. By default, the dump file includes all current logs. You can use the filter options to export log entries that meet the specified criteria. For instance, you can set filter options to display log entries for a specific period or a specific job ID number, and then export these entries to a dump file.

To export logs:

In the Navigation pane, click View Logs.

On the View Logs page, click Export.

In the Export Logs dialog box, configure the following options.

Table 77. Export logs
Option	Description
File Name	Type a filename for the log file. You can also select an existing file from the dump file list. If you select or specify an existing file, NetVault overwrites the file. Depending on the dump format selected, the dump files are created in the binary, text, or pgdump directories under <NetVault home>\logs\dumps (on Windows) or <NetVault home>/logs/dumps (on Linux). To create the dump file in a different location, specify the full path.
Binary Log	Select this option to export the logs to a binary file (.nlg).
Text Log	Select this option to export the logs to a text file (.txt).
Database Table Dump	Select this option to export the logs to a PostgreSQL dump (pg_dump) file (.dmp). NOTE: When you want to provide the log dump file to Quest Technical Support, use the Database Table Dump format.