Command Line Interface (CLI)

The Application Monitoring Metrics Command Line Interface (CLI) consists of a portable Java archive (JAR-file). The java file has all dependencies built in and the only requirement is a locally installed Java runtime. It can be used either locally or remote to query metrics from IFS Applications.

Application Monitoring Metrics CLI can be found in <build home>/external/fndbas/monitoring/application-monitoring-metrics-cli.jar

The CLI is modular built and can query metrics from different data sources:

Output types:

Prerequisites

Performance Impact

System Maintenance Considerations

Since the monitoring CLI is normally called from a 3pp monitoring product it will not be paused by the IFS installer. The CLI will use/lock java, mws and DB resources while executing a metric. These short locks might interfere with the depolyment of new code in several different areas in IFS Applications. It is therefore strongly recommended to temporary pause the use of the monitoring CLI during patching of IFS Applications.

Help

A helptext is provided with the Application Monitoring Metrics CLI and can be accessed via commandline.
The help text is also available on the page Command Line Interface (CLI) - Help.

java -jar application-monitoring-metrics-cli.jar -help

Version

The version of the Application Monitoring Metrics CLI is displayed via the command line below.

java -jar application-monitoring-metrics-cli.jar -version

Data sources

MWS

Predefined set of metrics related to IFS Middleware Server.

For more information run following command.
java -jar ifs-application-monitoring-metrics-cli.jar mws -help

DB

Predefined metrics is defined in IFS Solution Manager > Monitoring > Application Monitoring > Application Monitoring Entries and is queried by their "EntryID"-name.

Custom querys can be added in the Application Monitoring Entries. These metrics can then be queried from the Application Monitoring Metrics CLI.

For more information run following command.
java -jar ifs-application-monitoring-metrics-cli.jar db -help

HTTP

Metrics related to HTTP/HTTPS resources. Can match HTTP response, content, server-status and certificate validity.

For more information run following command.
java -jar ifs-application-monitoring-metrics-cli.jar http -help

FILE

Metrics related to file resources. Can match if a file exists and the filesize.

For more information run following command.
java -jar ifs-application-monitoring-metrics-cli.jar file -help

SYSLOAD

Metrics related to overall system performance.

For more information run following command.
java -jar ifs-application-monitoring-metrics-cli.jar sysload -help

Example: Central Monitoring Use Case

Goal: A central monitoring software monitors IFS Applications via Application Monitoring Metrics CLI to ensure application availability.

A 3:rd party central monitoring software is setup together with corresponding monitoring agents. The monitoring agents requests metrics from the Application Monitoring Metrics CLI and sends the response back to the central monitoring software.

The Application Monitoring Metrics CLI is portable and therefor run as close to the monitored resources as possible. For example when monitoring Crystal, the Application Monitoring Metrics CLI is run from the machine running Crystal reports.


 

Example: visualization of IFS Application Metrics in a 3:rd party central monitoring solution.

In this example action need to be taken related to Invalid Objects, Batch Processor and Triggers to ensure application availability.