Command Line Interface (CLI) - Help

Version: 0.6.6
Usage:
java -jar application-monitoring-metrics-cli.jar -help
java -jar application-monitoring-metrics-cli.jar <datasource> [-help] <plugin flags> [<default flags>] [-out=<outputtype>]

Note:
The exit code of this cli can be used to determine the status of a request. The exit codes is explained further in the properties file.
The use of '-' sign before any flag can be omitted. Also the '=' sign between flag and value may be replaced by a space.

<datasource>
mws|db|http|file|sysload

<default flags>:
-ca=value Critical above value
-cb=value Critical below value
-wa=value Warning above value
-wb=value Warning below value
-d[o|w|c|u] Default to OK|Warning|Critical|Unknown
-[o|w|c|u]eq=value String value defining the state OK|Warning|Critical|Unknown. Semicolon-separated list.

<outputtype>
[default|report|json|nagios|...] Output type specified in the parameter file as "out.<outputtype>" with custom layout.

MWS data source

Usage:
java -jar application-monitoring-metrics-cli.jar mws -help
java -jar application-monitoring-metrics-cli.jar mws -host=value -port=value -user=value -pass=value -server=value -request=value [<default flags>] [-out=<outputtype>]

<plugin flags>
-host=value Server hosting the database
-port=value JMX port name (default 58102 for ManagedServer1 in IFS Applications 9)
-user=value Username
-pass=value Password
-server=value Server runtime, i.e. 'ManagedServer1' or 'ManagedServer2'. Case-sensitive.
-request=value Request for value defined as 'Entry ID' in IFS Solution Manager > Monitoring > Application Monitoring > Application Monitoring Entries
fndbas[xa]_status
fndbas[xa]_currcapacity
fndbas[xa]_current_count
fndbas[xa]_avg_wait
plsql_switch_user_percentage
plsql_waited_requests_percentage
stuck_threads
healthstateid
applications_started

Examples:
java -jar application-monitoring-metrics-cli.jar mws -host=localhost -port=58102 -user=ifsmon -pass=<pass> -request=fndbas_avg_wait -server=ManagedServer1 -wa=500 -ca=1000 -out=report

DB data source

Usage:
java -jar application-monitoring-metrics-cli.jar db -help
java -jar application-monitoring-metrics-cli.jar db -host=value -instance=value -user=value -pass=value -request=value [<default flags>] [-out=<outputtype>]

<plugin flags>
-host=value Server hosting the database
[-port=value] (optional) Oracle port (default: 1521)
-instance=value Instance name. Case-sensitive.
-user=value Username
-pass=value Password
-appowner=value IFS Application Owner user name (Defaults to IFSAPP)
-request=value Request for value defined as 'Entry ID' in IFS Solution Manager > Monitoring > Applicaiton Monitoring > Application Monitoring Entries

Examples:
java -jar application-monitoring-metrics-cli.jar db -host=localhost -instance=<instancename> -user=ifsmonitoring -pass=<password> -request=INVALID_BODIES -ca=0 -out=report

HTTP data source

Usage:
java -jar application-monitoring-metrics-cli.jar http -help
java -jar application-monitoring-metrics-cli.jar http -url=value [-post=payload] -match=value [-name=value] [<default flags>] [-out=<outputtype>]

<plugin flags>
-url=value Url to resource
-post=payload Post payload. i.e. "{\"SystemID\":\"my.system.id\"}". If not specified the request will be GET.
-match=value Match part of the response to regex pattern provided with the flags "-[o|w|c|u]eq"
all Match any part of the response
response (default) Match the response code (i.e. 200|404|302 etc.)
body Match the body content
server-status Match Apache server-status page
certificate Verify Certificate is valid
login Simulate Aurena login with given database user and password
-name=value (optional) Custom name for the request (defaults to the -url value)
-user=value (optional) Used when -match=login
-pass=value (optional) Used when -match=login
-[o|w|c|u]eq regex Semicolon separated list of pattern to match against. If regex group is used the group content will be used in the output.

Examples:
java -jar application-monitoring-metrics-cli.jar http -url=https://<url>/ -match=response -oeq="200" -ceq="404" -weq="301;302"
java -jar application-monitoring-metrics-cli.jar http -url=https://<url>/ -match=body -oeq="MyValue:([0-9]*?)" -du
java -jar application-monitoring-metrics-cli.jar http -url=https://<url>/server-status?auto -match=server-status
java -jar application-monitoring-metrics-cli.jar http -url=https://<url>/ -match=certificate -cb=30 -wb=60
java -jar application-monitoring-metrics-cli.jar http -url=https://<url>/ -match=login -user=<user> -pass=<password> -oeq="200" -weq="401" -dc

File data source

Usage:
java -jar application-monitoring-metrics-cli.jar file -help
java -jar application-monitoring-metrics-cli.jar file -file(s)=value -match=value [<default flags>] [-out=<outputtype>]

<plugin flags>
-file(s)=value Semicolon separated list of files-match=value
filesize Match filesize (bytes)
exists Returns 'true' if file exists and 'false' if not.
-[o|w|c|u]eq regex Semicolon separated list of pattern to match against. If regex group is used the group content will be used in the output.

Examples:
java -jar application-monitoring-metrics-cli.jar file -files="my-document.txt" -match=filesize

Sysload data source

Usage:
java -jar application-monitoring-metrics-cli.jar SYSLOAD -help
java -jar application-monitoring-metrics-cli.jar SYSLOAD -url -user -pass
<plugin flags>
-url=<value Url to resource>
-user=<value Username>
-pass=<value Password>

Examples:
java -jar application-monitoring-metrics-cli.jar SYSLOAD -url https://<url>/ -user ifsapp -pass ifsapp