Application Monitoring Metrics 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:

• MWS (IFS Middleware Server)
• DB (IFS Oracle Database)
• HTTP (HTTP/HTTPS resources)
• FILE (File resources)

Output types:

• Text (default) - Returns requested metric value
• JSON - Returns requested metric value and threasholds in JSON format.
• Nagios - Returns requested metric, threasholds and performance data suitable for Nagios based monitoring softwares
• Custom - Output from the CLI is customizable via the properties file (created at first run)
  

Prerequisites

• Java 1.8+
• Java bin folder specified in the Path

Performance Impact

• The CLI consumes ~20Mb memory per execution.
• When using data source DB: The performance impact on the database instance may vary depending on the defined SQL query. To limit the performance impact follow the recommended intervals for querying the DB data source specified in the Application Monitoring Metrics documentation.

Help

A helptext is provided with the Application Monitoring Metrics CLI and can be accessed via commandline.

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

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

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.