#man NSR_RENDER_LOG

NAME

nsr_render_log − output NetWorker log file data in human-readable form

SYNOPSIS

nsr_render_log

[ −acdeghlmprtyz ] [ −L locale ] [ −S start_time | "l locale_start_time" ] [ −E end_time | "l locale_end_time" ] [ −N number_of_lines ] [ −x export_spec ] [ −T thread_id ] [ −P process_id ] [ −O program_name ] [ −G group_name ] [ −B start_line ] [ −M message_id ] [ −H hostname ] [ −J hostname_referenced ] [ −A activity_id ] [ −C category ] [ −F devicename ] [ −Y severity ] log_file_name

DESCRIPTION

nsr_render_log reads messages from the NetWorker log file log_file_name , 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 time stamps are formatted to that locale. If the messages cannot be rendered in the specified locale language then the messages are rendered in english. nsr_render_logs assumes that the proper fonts are configured by the user.

OPTIONS

−a

Do not output the activity ID.

−c

Do not output the category.

−d

Do not output the timestamp.

−e

Do not output the error number.

−g

Do not output the program name.

−h

Do not output the host name.

−l

Output the header information line before the log output.

−m

Do not output the message ID.

−p

Do not output the process ID.

−t

Do not output the thread ID.

−y

Do not output the severity.

−z

Obfuscate secure information. Hostnames, usernames and network addresses shall be aliased.

−x <export_spec>

As an alternative to the default human-readable output format, export_spec provides for a user defined output format separator. The export-spec ’c<separator>’ displays values separated by <separator>. For example, ’nsr_render_log -x ’c \t’ <file_name>, will produce tab separated values.

−L locale

Output is translated, and time is formatted, to the specified locale.

−S

[ start_time | "l locale_start_time" ]

Messages dated earlier than start_time will not be output. The date specified can be in nsr_getdate(3) format, or locale date format when "l locale_start_time" is specified. Note that the surrounding quotes and a blank space after "l" are required for locale date format. The input locale date/time follows the format display of ’ls -l’ command of recover on UNIX and ’dir’ command of recover on windows. For example, in an English locale and on a UNIX machine ’nsr_render_log -S " l may 30 4:00 " <log_file_name>’ will produce all the messages dated later than May 30th 4:00. With the ’l’ specification if no start time or an invalid start time is specified then the time is mapped to the start of the day (00:00:00).

See changetime command in recover man page for more information on the locale_date format supported.

−E

[ end_time | "l locale_end_time" ]

Messages dated later than end_time will not be output. The date specified can be in nsr_getdate(3) format, or locale date format when "l locale_end_time" is specified. Note that the surrounding quotes and a blank space after "l" are required for locale date format. The input locale date/time follows the format display of ’ls -l’ command of recover on UNIX and ’dir’ command of recover on windows. For example, in an English locale and on a UNIX machine ’nsr_render_log -E " l may 30 4:00 " <log_file_name>’ will produce all the messages dated earlier than May 30th 4:00. With the ’l’ specification if no end time or an invalid end time is specified then the time is mapped to the end of the day (23:59:59).

See changetime command in recover man page for more information on the locale_date format supported.

−N lines

The maximum number of lines that are required to be printed. If there are not sufficient number of lines then the available number of lines shall be printed. If this option is specified along with the Start time then N lines are rendered after the Start time stamp.

−B start_line

Output only messages starting with this line number. If the given ’start_line’ value is negative then it will retrieve the specified number of lines from the end of file.

−T thread_id

Output only messages written by the specified thread ID(s). Multiple TIDs up to a limitof 8 may be entered. Each shall be separated by a space and the whole set enclosed within double quotes.

−P process_id

Output only messages written by the specified process ID(s). Multiple PIDs up to a limit of 8 may be entered. Each shall be separated by a space and the whole set enclosed within double quotes.

−O program_name

Output only messages written by the specified program name(s). Multiple program names up to a limit of 8 may be entered. Each shall be separated by a space and the whole set enclosed within double quotes.

−G group_name

Output only messages written by the specified savegroup name(s). Multiple savegroup names up to a limit of 8 may be entered. Each shall be separated by a space and the whole set enclosed within double quotes.

−M message_id

Output only messages having the specified message ID(s). Multiple Message IDs up to a limit of 8 may be entered. Each shall be separated by a space and the whole set enclosed within double quotes.

−H hostname

Output only messages written by the specified host(s). Multiple HostNames up to a limit of 8 may be entered. Each shall be separated by a space and the whole set enclosed within double quotes.

−A activity ID

Output only messages having the specified activity ID. Multiple activity IDs up to a limit of 8 may be entered. Each shall be separated by a space and the whole set enclosed within double quotes.

−C category

Output only messages having the specified message category. Multiple message categories up to a limit of 8 may be entered. Each shall be separated by a space and the whole set enclosed within double quotes.

−F device name

Output only messages having a reference to the specified device name. Multiple devie names up to a limit of 8 may be entered. Each shall be separated by a space and the whole set enclosed within double quotes.

−J host name referenced

Output only messages havinga reference to the specified host name. Multiple host names up to a limit of 8 may be entered. Each shall be separated by a space and the whole set enclosed within double quotes.

−Y severity

Output only messages having a severity level equal to or more than the specified severity level.

log_file_name

Read messages from the file named by the path name log_file_name

EXAMPLES

Example 1: To translate log to Japanese, with a header line and obfuscation.

nsr_render_log -lz -L ja_JP.utf8 /nsr/logs/daemon.raw

Example 2: To render log messages generated by pid’s 41, 1064 and 1065, suppressing thread and activity/eventID output, searching only the last 50 lines of the log file and redirect output

nsr_render_log -ta -P "41 1064 1065" -B -50 ./recover.raw > recover.txt

Example 3: To render first 99 log messages between 11:00 AM and 12:00 AM on Jan 30, 2006 with a severity level 2.

nsr_render_log -S "Jan 30 11:00" -E "Jan 30 12:00" -N 99 -Y 2 /nsr/logs/daemon.raw

NOTES

1: For each backslash ( " \ " ) character in the path, enter two backslashes in succession.

Example: c:\\dir_one\\dir_two\\daemon.raw

2: If the user is rendering the messages to a locale other than the locale of the shell, then the output will be UTF-8 encoded. If this UTF-8 output is piped to a file, then it is the responsibility of the user to make sure that the file supports UTF-8 encoding.

SEE ALSO

nsr_getdate(3)