System Logging - Historical Tab

The Historical tab provides a searchable view of a NetWitness log or a service log in a paged format. When initially loaded, the grid shows the last page of the log entries for the system or the system.

To access the Historical tab:

  1. Go to netwitness_adminicon_25x22.png (Admin) > System.
  2. In the options panel, select System Logging.

    The System Logging panel opens to the Realtime tab by default.

  3. Click the Historical tab.

What do you want to do?

Role I want to ... Show me how
Administrator View the Historical Graph Historical Graph for System Stats

Related Topics

System Logging - Realtime Tab

System Logging - Settings View

Quick Look

The following is an example of the Historical tab in the System Logging panel. It shows the NetWitness logs.netwitness_121_histtab_1122.png

1 Displays System Logging Tab
2 Displays Historical Tab

The following is an example of the Historical tab in the Services Logs view. It shows the services logs.netwitness_121_histsertab_1122.png

Features

The Historical tab has a toolbar with input fields to allow filtering of the entries, a grid containing the log entries, and paging tools.

Feature Description
Start Date and End Date The Start Date and End Date range search options limit the log entries to a point in time. When used, you must provide both a start and end date. The times are optional. The date range is validated to assure that the end date is not before the start date.
Log Level drop-down netwitness_systemloggingtypefilter_55x90.png
Selects the log level for entries to display in the grid. The Log Level drop-down shows the available log levels for the system or the service.
  • System logs have seven log levels.
  • Service logs have only six log levels because they do not include the TRACE level.
  • The default is ALL log entries.
Keyword field Specifies a keyword to use when filtering entries. This field is the same for system and service log filtering.
Service field (Service Logs only) Specifies the service type to use when filtering service log entries. Possible values are the host or the service.
Search button Click to activate a search based on the start and end date, log level, keyword, and service selections.
Export Click to export the currently viewed grid entries to a text file. You can select either comma-separated or tab-separated format for the entries in the file.

Column Description
Timestamp This is the timestamp for the entry.
Level This is the log level for the message.
Message This is the text of the log entry.

The paging tools below the grid provide a way to navigate through the pages of log entries.

netwitness_104syslogpagetb_240x27.png

Search Log Entries

To search the results shown in the Historical tab:

  1. (Optional) Select a Start Date and End Date. Optionally, select a Start Time and End Time.
  2. (Optional) For system and service logs, select a Log Level and a Keyword, or both.
  3. (Optional) For service logs, select the Service: host or service.
  4. Click Search.
    The view is refreshed with the most recent 10 entries matching your filter. As new matching log entries become available, the view is updated to show those entries.

Show Details of a Log Entry

Each row of the Historical tab Log grid provides the summary information of a log entry. To view complete details:

  1. Double-click a log entry.

    The Log Message dialog, which contains the Timestamp, Logger Name, Thread, Level and Message, is displayed.

    netwitness_104svslogmessagedb.png

  2. When finished viewing, click Close.

Page Through the Entries

To view the different pages of the grid, use the paging controls on the bottom of the grid as follows:

  • Use the navigation buttons
  • Manually enter the page you want to view, and press ENTER.

Export

To export the logs in the current view:

Click Export, and select one of the drop-down options, CSV Format or Tab Delimited.
The file is downloaded with a filename that identifies the log type and the field delimiter. For example, a NetWitness system log exported with comma-separated values is named UAP_log_export_CSV.txt, and an appliance log exported with tab-separated values is named APPLIANCE_log_export_TAB.txt.