jmx4perl/CHANGES

1.12 (2015-07-28)

  - Configuration can be also a directory in wich case <dir>/jmx4perl.cfg is tried
    (e.g. ~/.j4p/jmx4perl.cfg)
  - Added Docker build
  - Fix boolean values to be strings "true"/"false" when deserialized. 
  - Changed from "Nagios::Plugin" to "Monitoring::Plugin"

1.11 (2014-11-22)

  - When within a MultiCheck a single check causes an exception, the
    other checks are now still present in the output of check_jmx4perl
    and the overall check has the status UNKNWON (#40)
  - Minor fixes on the WebSphere Checks
  - Fixed issue when calling check_jmx4perl for an operation without argument (RT##98166)

1.10 (2014-06-30)

  - Added WebSphere checks

1.08 (2014-06-30)
  - Fixed warning when using MBeanName (#31)
  - Fixed BaseMBean and formatting
  - Fixed relative checks when using MBean patterns
  - Added formatter '%q' to include a ratio of value to base without
    multiplying by 100 like for '%r'
  - Disabled OpenPGPVerifier since it doesn't support the new digest
    algorithms used for signing the Jolokia artefacts (#32)
  - Don't set ssl_opts if on LWP < 6 (#28)
  - Fixed BaseMBean and BaseAttribute config directives (#25)
  - Fixed regexp for squeezing trailing slashes (RT#89108)
  - Fixed check definition for 'wls_channel_connections (RT#89107)
  - Changed check 'memory_gc_time' to be a relative check to measure the 
    relative amount taken for the GC. If you use this check (or a sub-check of this)
    YOU NEED TO UPDATE YOUR THRESHOLDS (and regenerate the pn4p graphics) if you use this 
    check directly
  - Fixed bug when using 0 thresholds in checks using parent checks (#38)
  - Added support for '*' wildcard when navigation with cd for j4psh 
  - Fixed bug with check inheritance and check parameters which contain parantheses
  - Added an option "MultiCheckPrefix" for "Checks" in order to specify the prefix 
    for multi checks 
  - Added config options "SummaryOk" and "SummaryFailure" for allowing to fine tune 
    multi check output (#24)
  - "Argument" can be used in "Operation" config checks for providing arguments to 
    Nagios checks which are based on operations (#27)

1.07 (2013-04-16) 
  - Added more robust timeout for the Jmx4Perl Agent (requires Sys::SigAction)
  - SSL Host key verification switched off when connecting via SSL
  - Fixed issue with quoting in j4psh (#14)
  - 'cat' in j4psh is now caseinsensitive when using wildcards (#18)
  - Added BaseMBean, BaseAttribute and BasePath as alternative to Base f
    or check_jmx4perl (#16)
  - "jolokia" can do 'repack' and 'info' also when not being connected 
    to the internet (#20)
  - Multi-Checks can now reference other Multi-Checks either via <MultiCheck>
    or <Check> (#19)
  - Added new option '--perfdata true|false' (PerData false in configuration) for 
    switching of performance data. Also, for string checks performance data is 
    switched off always. (#22)
  - Added %y and %z as placeholder for configured CRITICAL and WARNING thresholds
    for the output provided with "Label" in check_jmx4perl (#13)

1.06 (2012-10-13)
  - A a scripting mode to check_jmx4perl which allows putting in arbitraty 
    Perl code for extracting the value to match against
  - weblogic specific Nagios checks added
  - Added name as optional parameter for Nagios checks in tomcat.cfg (thanks Wolfgang)
  - When a multi checks fails, then the name of the check is added instead of its definition 
    key. This allows for better direct usage of predefined checks in own multi checks.
  - If neither a CRITICAL nor a WARNING threshold is provided, then
    the check always returns OK. This is especially useful when the
    motivation is to only collect performance data. 
    
1.05 (2012-04-22)
  - Added Time::HiRes as dependency to check_jmx4perl
  - Replaced XML::Tidy with XML::Twig and relaxed version number
    requirement on Module::Build
  - RT#72413: Fixed configuration in threads.cfg
  - Updated documentation for 'jmx4perl' (--method and --legacy-escape
    explained) 
  - Bundled Module::Build 0.34 in order to improve the installation
    experience
  - j4psh: Added 'pwd' command
  - j4psh: Added options -a (attributes) and -o (operatiosn) to the 'ls'
    command which now also supports wildcards for filtering

1.04 (2011-11-27)
  - Fixed serious (and stupid) bug for jmx4perl and j4psh when printing 
    out scalar values. 

1.03 (2011-11-23)
  - Fixed stupid last minute bug.

1.02 (2011-11-23)
  - Fix for threshold with 0 value in check_jmx4perl
  - Fix automatic detection of the largest version number for Jolokia
    agents in with the format 1.0.1 when downloading with 'jolokia' 
  - Fixed printing of boolean values for jmx4perl and j4psh for 
    complex data structures (finally)
  - Added option '--option key=val' to jmx4perl and j4psh for tuning the 
    output format of these tools (known keys: format,booleans,indent)
  - Added '--target' to j4psh so that it can operate against a JSR-160 
    proxy

1.01 (2011-10-25)
  - Fixed 'jolokia' to load the new renamed jvm agent.
  - Fixed issue when printing boolean values with jmx4perl
  - Fixed issue with LWP as old as 5.805
  - Bumped required version of Module::Build to 0.38 in order to cope
    with messed up version number of XML::Tidy.
  - j4psh works now with  Getopt::Long before 2.38

1.00 (2011-10-3)
  - Changed escaping as introduced by Jolokia 1.0. If talking with
    Jolokia < 1.0, use the option '--legacy-escape' must be used if
    using GET requests with MBeans containing / in the
    name. JMX::Jmx4Perl knows this option as well
    ('legacy-escape'). j4psh does the detection automatically,
    jmx4perl, check_jmx4perl and cacti_jmx4perl know about the new
    configuration option.  
  - That's 1.0

0.95 (2011-8-21)
  - Fixed Cacti output when labels contains spaces
  - Tuned ancient Perl coding style (thanks, datamuc)
  - Fixed problem with jolokia and PGP verification in non-english
    environments.
  - Fixed 'search' command which now really returns undef if nothing 
    is found (and not a ref to an empty array). That will also fix some
    detectors when the 'info' command is used. 

0.92 (2011-5-9)
  - Fixed bug in pack specification (encryption) which is not available for 
    Perl 5.8 (and which broke Jmx4Perl for Perl 5.8)

0.91 (2011-5-6)
  - Added --unknown-is-critical option to map all UNKNOWN to CRITICAL values (RT#67899)
  - Added jmx4perl back to the build process, which was forgotten in 0.90
  - Fixed bug RT#67815 which was caused by an invalid replacement of placeholder
    for certain cases (i.e. is during parent check definition resolving
    ($0,$1) needs to be replaced by ($1,$2) which ended up falsely as ($2,$2)).
  - Implemented --timeout option for check_jmx4perl, which is a pure HTTP timeout 
    for the communication between the Nagios checks and the Jolokia agent (RT#67821)
  - Added a possibility to store encrypted passwords in the configuration file.
    Please note, that this is *not* secure and only prevents casual attacks, since
    the password needs to be symmetrically decrypted before passing it to the server. 
    In order to create an encrypted password, use 'jmx4perl encrypt <passwd>'.
  - Fixed RT#67772 which prevented the proper count of failed checks for non-relative 
    checks within multi checks

0.90 (2011-4-11)
  - Tuned Build.PL so that scripts can be added conditionally.
  - Fixed normalization issue with negative delta check values.
  - Support for new JSON serialization style of Jolokia 0.90 added. 
    (i.e numbers and booleans are not returned as plain strings anymore
    but as Long, Double, true/false. Null is returned as JSON-null.
    If you have trouble with boolean checks in check_jmx4perl, please
    update to this jmx4perl version.
  - Added 'jolokia' for downloading and managing Jolokia agents
  - Removed jmx4perl Java agent source and agent since jmx4perl now uses
    Jolokia as agents (www.jolokia.org)
  - Added 'cacti_jmx4perl', a tool for gathering Cacti data (www.cacti.net) 
    It is heavily based on 'check_jmx4perl' (without threshold handling). 
 
0.75 (2011-2-4)
  - Fixed typo in POD documentation which prevented a successful 
    build in some situations

0.74 (2011-1-16)
  - Fixed problem with multichecks including operation-checks with
    arguments. Specifying them in a configuration has been falsely
    ignored. 
  - Added '--method' command line option and 'Method' check
    configuration option to check_jmx4perl for selecting the prefered
    HTTP request method. 
  - Fixed normalization of time values (RT #63545)
  - Improved default check_jmx4perl configuration (in hopefully a backward 
    compatible way)
  - Multi check service summary now contains the name of failed services
  - Fixed problems with a single '/' argument (RT #62915)

0.73 (2010-11-03)
  - Fixed RT #61903 which occurs when the same check is referenced 
    multiple times (with potentially different parameters) in a 
    multicheck scenario.
  - Fixed RT #62342: Perl warning when using operations and not --name
    in check_jmx4perl
  - Added --method to jmx4perl, config option 'method' for JMX::Jmx4Perl 
    in order to allow a default HTTP Method to use.
  - Changed request command constant 'VERSION' to 'AGENT_VERSION' in 
    order to avoid conflicts with the usual versioning conventions for 
    Perl Modules. This is an API change, so in case you are using requests
    with the constant VERSION you should change this to AGENT_VERSION 
  - Fixed issues when browsing with less in j4psh
  - Extended config handling in j4psh to allow includes

0.72 (2010-9-24)
  - Fixed problem with quotes in the config when using "Value"
    and/or "Base".
  - Adapted tomcat.cfg to be more flexible (e.g. replaced 'Catalina'
    domain part by a wildcard).
  - Fixed bug for merged MBeanServers when using multiple attributes 
    and/or MBean patterns for a READ request
  - Fixed broken --target, --target-user and --target-password for 
    check_jmx4perl (same for --proxy and co.)
  - Tuned output of complex data in j4psh
  - Unwrap an MBeanException to use the target exception for an error 
    message
  - Agent tested with Mule 3.0

0.71 (2010-8-16)
  - Added 'ns' as unit (CpuThreadTime returns nano seconds)
  - Fixed quoting of performance data in so far to let 
    Nagios::Plugin the complete control
  - Fixed '--color' option and UseColor config directive 
    (section: <Shell>) to j4psh
  - Added detection of a suitable pager for j4psh
  - Fixed bug in server configuration when using old style syntax

0.70 (2010-7-10)
  - Extended configuration syntax for check_jmx4perl as an alternative to
    command line options
    + Parameterized checks
    + Default values for parameters
    + Multichecks (one HTTP request, many JMX requests)
    + Check-Inheritance
    + Predefined checks for certain environments (as sample configuration files)
    + Added null value check, can be tuned with --null
  - Added '--value' as a shortcut for --mbean/--attribute/--value  
  - Better documentation for check_jmx4perl (30 extra pages)
  - <Server> sections are now named blocks, taking the server name as block 
    name (similar to <Check>). The old syntax with an "Name" argument is 
    still support but must not be mixed with the new syntax.
  - Path elements containing '/' can now be escaped with '\/'
  - j4p-osgi-bundle including pax-web-bundle so only a single bundle
    is needed for deploying (when no OSGi HttpService is installed)
  - Relaxed version requirements on core and compendium OSGi classes
    for j4p-osgi bundle.
  - Changed access restrictions (j4p-access.xml):
    + <allow> and <deny>
    + Wildcards (*) for attribute and operation names
    + WARNING: Semantics of MBean specification has changed. Please
      read the comments in j4p-access.xml.template
    + Add logging (level info) for printing out which security policy
      is used
  - Started to add a java client library
  - j4psh beta version added
  - Agent: 
    + Switched from JUnit to TestNG for testing because of
      support of testing groups 
    + New servlet init parameter option 'mbeanQualifier' to allow
      multiple j4p-servlet in a single application server

0.65 (2010-3-30)
  - A JDK 6 java agent added for exporting the j4p protocol via
    HTTP/JSON.
  - Extended READ operation to support MBean patternames and multiple
    attributes with a single request
  - Renamed 'max_depth', 'max_list_size','max_objects' as processing 
    configuration parameters to 'maxDepth', 'maxCollectionSize' and
    'maxObjects' respectively for consistencies sake.
  - Bug fix: POST request respect these parameters as well now 
  - Added 'ignoreErrors' request option in order to allow a bulk read
    to succeed even if single read fails. In this case, the valu will 
  - 'search' returns properly escaped MBean Names if unsafe characters
    are used. 
  - For GET request, instead of pathinfo a query with parameter 'p'
    can be used as alternative. This works around certain issues with
    special path handling with certain app-servers (e.g. Tomcat). 
  - JMX::Jmx4Perl::Request and JMX::Jmx4Perl::Agent hardened in order
    to be more smart with unsafe MBean Names and detect automatically
    the most convenient HTTP Request method (if not explicitely set)
  - Added more unit and integration tests.
  - Added VERSION command to JMX::Jmx4Perl to get to agent and
    protocol version
  - Fixed error handling for bulk requests. Now each request object
    will return an associated response object even in the error case.
  - Fixed JMX::Jmx4Perl::info for IBM JVMs
  - Added JMX::Jmx4Perl->parse_name() for splitting up a given MBean
    object name into its parts

0.60  (2009-02-28)
  - OSGi bundle (including dependencies) for exposing JSON export via
    the OSGi HTTP-Service. It's in agent/modules/j4p-osgi.
  - Refined error handling
  - Removed legacy JDK 1.4 support. 0.36 is the one and only version
    for which the JDK 1.4 backport has been tested to some amount.
  - Added support for overloaded JMX operations for 'list' and 'exec'
  - 'read' operation can now be used without attribute name in which
    case the value of all attributes is returned. This can be used
    directly with JMX::Jmx4Perl and the frontend jmx4perl.
  - Support for Resin 3.1 added
  - 'exec' operation can now deal with simple array arguments. Within
    the perl modules, give an array ref for an array argument. This
    gets translated to a comma separated list of values in the
    string. For string array this works only with simle content
    (i.e. no element containing a ',')

0.51 (2009-12-30)
  - Quickfix for a badly packaged agent/j4p.war

0.50 (2009-12-24)
  - Protocol of j4p.war has been extended to enable proxy mode
  - Added '--target' to check_jmx4perl for using proxy mode
  - Added '--target' to jmx4perl
  - Added Mule agent. Use maven to build it in agent/modules/j4p-mule  
  - 'get_war' and 'get_mule_agent' as actions for Build.PL for
    fetching java artifacts from the labs.consol.de maven repository.
  - Cleaned up and updated Manual.pod

0.40 (2009-11-14)
  - Extended protocol to allow for JSON requests via POST in addition
    to pure URL based requests via GET
  - Implemented bulk requests: JMX::Jmx4Perl->request() can now take a
    list of JMX::Jmx4Perl::Request objects in which case it will
    return a list of JMX::Jmx4Perl::Response objects (instead of a
    single, scalar, response when used with a single request)
  - Support for Glassfish V3 Preview, Jonas 5.1 and Jetty 7.0.0

0.36 (2009-10-30)
  - Added <remote> to j4p-access.xml for restricting 
    access to certain hosts or subnets only.
  - Added support for a JDK 1.4 agent war. The feature base for 
    this agent is frozen. It might even vanish in the future.
    You need a JDK 1.4 agent for running within Weblogic 8.1
  - Cleaned up j4p agent with help of sonar and associated 
    metric checkers like PMD, check_style and FindBugs.
  - Added support for config files in jmx4perl and JMX::Jmx4Perl 
    which allows for shortcuts for agent URL as well as storing 
    user and credentials information.
  - Fixed some bugs

0.35 (2009-08-15)
  - Added example 'threadDump.pl'
  - Fixed bug when serializing floats and doubles.
  - check_jmx4perl: 
    * Added support for checking string and boolean values
    * Escaping performance data
    * Include units-of-measurement in the plugin output
    * Custom labeling of plugin output
    * Perfdata contains always absolute values, even when 
      used with --base

0.30 (2009-07-31)
  - Fixed permission issue while running 'Build dist'
  - Fixed URL generation for Websphere
  - Added support for generic Bean serialization
  - Added 'search' command to jmx4perl
  - Fixed bug when using pathes with multiple components
  - Added additional parameters 'max_depth', 'max_list_size' and
    'max_objects' to restrict the size of the JSON answer. Protocol
    has changed as well a bit.
  - jmx4perl: URL now as first argument for easier workflow when using
    bash history for repeated usage.
  - Added support for restricting MBean access via a policy file
    (j4p-access.xml)  

0.21 (2009-07-03)
  - Added '--proxy' for check_jmx4perl and jmx4perl
  - check_jmx4perl:
    + Refactored to work within the embedded Nagios Perl interpreter
      (ePN)  
    + use relative values in the range from 0 to 100%
      (for --critical and --warning) instead of [0..1]
    + Renamed '--base-value' to '--base' since it can take now
      absolute values (numbers) or "mbean/alias/path" tuples as an
      argument in addition to alias names.
    + Added '--operation' which allows for using return values of
      operations as check values
    + Added ~ 50 integration tests

0.20 (2009-06-28)
  - Support for writing attributes and executing operations 
  - Documentation fixes
  - Tested for WebLogic 9. New initial support for Websphere 6.1 and 
    7.0
  - New "version" command to j4p-agent
  - New "search" j4p-agent command for querying for MBean names
  - Added '--base-alias' to check_jmx4perl for using relative 
    thresholds
  - Added '--delta' to check_jmx4perl for using an incremental 
    mode
  - Cleaned up check_jmx4perl perfdata output
  - Added own j4p-agent MBean for configuration management 
    (history tracking and debugging info)
  - JMX::Jmx4Perl has new request short-cuts 'set_attribute' and 
    'execute'
  - Renamed j4p-agent.war to j4p.war
  - Started integration test suite below "it/" and "agent/modules/j4p-it"
    for installing some test beans
  - Cleaned up maven integration for the agent servlet
  - Moved repository to git://github.com/rhuss/jmx4perl.git

0.16
  - Switched off debugging in agent servlet
  - Fixed syntax error when using 'jmx4perl -v attributes'
  - Fixed Jetty Handler. 

0.15
  - Aliasing
  - Autodetection 
  - Command line tool "jmx4perl"
    * reading of attributes
    * listing of all availabel attributes and operations. 
    * listing of all attribute values
    * print server info
    * print all available aliases
  - Bug Fixes:
    * Correct URL encoding for request URL
    * Slash '/' needs to be custom encoded, since URI encoding doesn't 
      work for JBoss 4/5 due to a bug
  - Tested to work on JBoss 4 & 5, Oracle WebLogic 10, Jonas 4, Geronimo 2, 
    Glassfish 2, Tomcat 4-6 and Jetty 5 & 6 

0.1
  - Initial release
  - check_jmx4perl