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.


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). Also, multiple files / directories can be specified.

If no additional options are specified, the following processing occurs:


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.

Running without any options is equivalent to:
--nodata --nosummary \
-d <nmon_code>/src/com/ibm/nmon/report/dataset_report.xml \
-a <nmon_code>/src/com/ibm/nmon/report/summary_single_interval.xml \
<file|directory to parse>


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

Intervals File

The value given for -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.

Chart Format File

The value given for -f should be a valid properties file that specifies custom chart colors. The colors, as property values, can be specified as:

The following colors, as properties, can be set:

A sample dark theme could be something like the following: background=BLACK plotBackground=DARK_GRAY text=WHITE elements=[ 248, 248, 248 ] gridLines=0xa0a0a0 annotations=GREEN series=VERY_LIGHT_RED, VERY_LIGHT_BLUE, VERY_LIGHT_GREEN, VERY_LIGHT_YELLOW, VERY_LIGHT_CYAN, VERY_LIGHT_MAGENTA, LIGHT_RED, LIGHT_BLUE, LIGHT_GREEN, LIGHT_YELLOW, LIGHT_CYAN, LIGHT_MAGENTA