check_activemq

Usage
./check_activemq.pl [OPTIONS] [-f configuration_file]
Options

  • -h or --help: prints short usage tips

  • -V or --version: prints plugin versions

  • -v X or --verbose X: sets verbosity level to X (see UMI docs)

  • -t Y or --timeout Y: sets plugin execution timeout to Y seconds

Description

Plugin checks ActiveMQ broker health (the part of UNICORE accounting system). Written in Perl, v.5.10.0 (requires commons.pm module in plugin directory or one level higher). Needs java6 or higher. Probe checks size of the broker queue (warns if size exceedes 2000, fails if exceedes 10000), memory and store usage (warns at 80%, fails at 95%) and expire date of broker SSL certificate (warns if cerficate expires in next 2 weeks, fails if there are three on less days to expire).

Configuration file for plugin

  • JAMA_PATH: path to jeve executable

  • UCC_CONFIG: absolute path to valid configuration file for UCC (remember to set absolute paths to keystore and trustore in this file!)

  • ACTIVEMQ_URL: URL of ActieMQ broker

  • ACTIVEMQ_USERNAME: ActiveMQ username of user that is allowed to get stats

  • ACTIVEMQ_PASSWORD: ActiveMQ user password

  • ACTIVEMQ_QUEUE: Optional queue name (default: ActiveMQ.Statistics.Broker)

  • LOGS_DIR: Path to logs directory

Possible outputs with meaning

  • CRITICAL: Unable to connect broker at …: Unable to contact broker (see log to determine error).

  • CRITICAL: Missing … info: Some information is missing in broker response. It is probably misconfigured.

  • CRITICAL: … exceedes critical level: …: Some parameter exceedes critical level.

  • WARNING: … exceedes critical level: …: Some parameter exceedes warning level.

  • CRITICAL: SSL certificate expired: Broker SSL certificate has expired.

  • CRITICAL/WARNING: SSL certificate expires in … days: Broker SSL certificate is shot to expire.

  • OK: ActiveMQ Broker at … works: Everything works. Nagios pernormance data info contain actual values of tested parameters.