NetWorker: How to use nsr_render_log to render .raw log files

Summary: How to use nsr_render_log to collect logs.

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Instructions

nsr_render_log reads messages from the NetWorker raw log file, filters, and renders them according to the command-line options, and sends the output to stdout. The default language is English. If a locale is specified, the messages are output in the specified language, and the timestamps are formatted to that locale. If the messages cannot be rendered in the specified local language, then the messages are rendered in English. 

Logs files rendering cane be done on screen, send to a file, and send to a file in the background.

  • Render raw file on screen:
nsr_render_log raw_filename
  • Render a raw file to a text file:
nsr_render_log raw_filename > output_filename
  • Render a raw file to a text in the background:
nsr_render_log raw_filename > output_filename 2>&1
  • Render a raw file from a remote machine:
nsr_render_log -R hostname raw_filename > output_filename 2>&1
  • Render a raw file and only view log file messages for a specific device:
nsr_render_log -F devicename raw_filename > output_filename 2>&1
  • Render only the most recently logged messages:
nsr_render_log -B number raw_filename > output_filename 2>&1
  • Render messages from a specified time range:
nsr_render_log -S "start_timestamp" -E "end_timstamp" raw_filename > output_filename 2>&1
  • Render log in a specific time zone:
nsr_render_log -Z timezone raw_filename > output_filename 2>&1
NOTE: The nsr_render_log command renders the .raw log in the time zone that the command is run from. If you render the .raw file on a different system, the timestamps match the host running the command—not the original log source. This method can be used to render the logs in the same time as the original host when the nsr_render_log command is used on another system. Alternatively, this method can be used to render the log in a specific time zone. This may be useful when attempting to line up messaging between two hosts that are logging in different time zones.

Where:

raw_filename is the name of the unrendered file. For example, daemon.raw

output_filename is the name of the file to direct the output to.

hostname is the name of the host that contains the .raw file.

devicename is the name of the device
number Output only messages starting with this line number. If the given start_line value is negative, then it lines from the end of the file.

-h suppresses the hostname.

-y suppresses the message severity.

timezone is the UTC offset, for example:
-0000 UTC

Americas
-0330 Newfoundland Time 
-0400 Atlanta Time (AT)
-0500 Easter Time (ET)
-0600 Central Time (CT)
-0700 Mountain Time (MT)
-0800 Pacific Time (PT)

Europe, Middle East, Asia:
+0100 Central European Time (CET)
+0530 India Standard Time (IST)
+0900 Japan Standard Time
+1000 Australian Eastern

Examples:

NOTE: The below examples assume that the nsr_render_log command is run from the directory containing the .raw file. When the log file is not in the same directory as the command shell, specify the full path to the .raw log file. Additionally, the output file can be redirected to any folder of your choosing.

Render the whole daemon log to a file.

nsr_render_log daemon.raw > daemon.log

Render log messages from today only:

nsr_render_log -S "today" daemon.raw > daemon.log 2>&1

Render log messages with UTC timestamps:

nsr_render_log -Z -0000 daemon.raw > daemon.log 2>&1

Render log messages from within last week only:

nsr_render_log -S "1 weeks ago" daemon.raw > daemon.log 2>&1

Logic can be applied, using hours, days, weeks, and so forth.

Render log messages between two timestamps:

nsr_render_log -S "08/13/2024 09:00:00 AM" -E "08/13/2024 10:00:00 AM" daemon.raw > daemon.log 2>&1

Render log messages from Process IDs (PID) 41, 1064, and 1065. Suppress thread and event ID output, search only the last 50 lines, and redirect the output:

nsr_render_log -ta -P "41 1064 1065" -B -50 recover.raw > recover.txt
Display help messages: 
nsr_render_log -h
The NetWorker Command Reference Guide provides detailed information about the nsr_render_log program and the available options. NetWorker documentation is available through Dell Support.

Additional Information

NetWorker: Log Files and Locations

Affected Products

NetWorker, NetWorker Series

Products

NetWorker Family, NetWorker Series
Article Properties
Article Number: 000022793
Article Type: How To
Last Modified: 16 Sept 2025
Version:  8
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.