NMONVisualizer

command line

Report Generator

NMONVisualizer supports generating charts as PNG files from the command line. By default, it will create the same charts that are available in the GUI. Both the summary charts at the 'All Systems' level and charts for each host will be created in a charts subdirectory. There will be another subdirectory for each host's set of charts. Generation of these reports, along with the ability to create custom reports is supported via switches.

The charts produced by this utility default to displaying all the data that was parsed. Command line switches are also supported to specify the start and / or end datetimes for the charts as well as creating custom reports.

Running

To run the ReportGenerator, specify the class from the command line like the following:
java -jar NMONVisualizer_<release_date>.jar com.ibm.nmon.ReportGenerator <file|directory to parse>

Note that only nmon files are parsed. If a directory is given, then this directory will be searched recursively. so ensure that the JVM has enough memory allocated to it (via -Xmx).

Options

The -d, -a, --mt and --mf switches do not disable the default reports, hence the other switches to do this. Each of these switches can be specified multiple times to create a number of custom reports at once.

Since the --mt and --mf multiplex a single chart definition into multiple output charts, it is possible to create a large number of charts, especially when working with a large number of parsed data sets. In most cases, there should be a limited (maybe one) chart definition per file. Note that any chart subtitles are ignored. With --mt, the type name is used; with --mf, the field name is used. The file names used for the output will append the type or field, respectively. For the file name, types and fields are renamed as specified in the chart definition. The raw type or field name is use for the subtitle.

Neither of the -s and -e switches are required. Either one, both or none can be specified.

The intervals loaded when using -i will be in addition to the interval specified with the -s and / or -e switches. If more than one interval is loaded, a separate output directory for each interval will be created. All charts specified via the other switches will be created for each interval.

Errors

Any errors generated during parsing will be logged to a ReportGenerator_yyyMMdd_HHmmss.log log file.

Intervals File

The value given for the the -i should be a valid CSV file that contains at least one interval. The format of this file is interval name, start, end. The interval name is optional. Both the start and end must be a valid ISO 8601 datetime string.