# Configure your options with nmon.conf¶

The TA-nmon implements a main configuration file “nmon.conf” to be used for your customizations.

The configuration file uses the Splunk configuration philosophy (default versus local, etc…) such that you set your own options, and retain them over updates.

## Splunk HEC specific options¶

The TA-nmon-hec implements specific options:

Splunk HEC endpoint URL:

--splunk_http_url https://splunk.mydomain.com:8088/services/collector/event


Replace:

• “splunk.mydomain.com” by the fully qualified domain name or IP of your Load balanced VIP / Splunk HEC endpoint
• “https” by “http” if you don’t need to use SSL

Splunk HEC token:

--splunk_http_token insert_your_splunk_http_token


Replace:

• “insert_your_splunk_http_token” by the value of your token

local logging:

This option is active by default:

--no_local_log


When set, this will disable local logging on the machine running the TA-nmon-hec.

If you remove this option, the TA-nmon-hec will log every piece of data on the local machine:

$SPLUNK_HOME/var/log/nmon/nmon_perfdata.log$SPLUNK_HOME/var/log/nmon/nmon_configdata.log
$SPLUNK_HOME/var/log/nmon/nmon_processing.log$SPLUNK_HOME/var/log/nmon/nmon_collect.log


## Global options¶

These options are not related to nmon binary options but to the TA-nmon global configuration:

# This option can be used to force the technical add-on to use the Splunk configured value of the server hostname
# If for some reason, you need to use the Splunk host value instead of the system real hostname value, set this value to "1"

# We will search for the value of host=<value> in \$SPLUNK_HOME/etc/system/local/inputs.conf
# If no value can be found, or if the file does not exist, we will fallback to the normal behavior

# Default is use system hostname

# FQDN management in nmon2csv.pl/nmon2csv.py: The --fqdn option is not compatible with the host name override, if the override_sys_hostname
# is activated, the --fqdn argument will have no effect

override_sys_hostname="0"

# nmon external generation management

# This option will manage the activation or deactivation of the nmon external data generation at the lower level, before it comes to parsers
# default is activated (value=1), set to "0" to deactivate

nmon_external_generation="1"

# Fifo options

# This option will deactivate the auto switch to fifo mode, in other words the TA-nmon will use the file mode and the old mechanism
# unless you encounter unexpected issues, you should not switch to the old mechanism as the foot print is much higher

# Default is "1" which means write to fifo

mode_fifo="1"

# Since the release 1.3.0, AIX and Linux OS use the fifo_consumer.sh script to consume data produced by the fifo readers
# the following option allows specifying the options sent to the nmon2csv parsers

# consult the documentation to get the full list of available options

# --mode realtime|colddata|fifo --> explicitly manage realtime data
# --use_fqdn --> use the host fully qualified domain name
# --json_output --> generate the performance data in json format instead of regular csv data

# In fifo mode, options are sent by the fifo_consumer.sh
# In file mode, options are sent by Splunk via the nmon_processing stanza in props.conf

nmon2csv_options="--mode fifo"