Difference between revisions of "Plugin:Java"

From collectd Wiki
Jump to: navigation, search
(See also: Add "GenericJMX plugin".)
(Infobox Plugin: Added "Callback=" line.)
Line 2: Line 2:
 
   | Name=Java
 
   | Name=Java
 
   | Type=binding
 
   | Type=binding
   | Status=supported
+
  | Callbacks={{Callback|config}}, {{Callback|flush}}, {{Callback|init}}, {{Callback|log}}, {{Callback|notification}}, {{Callback|read}}, {{Callback|shutdown}}, {{Callback|write}}
 +
   | Status={{supported}}
 
   | FirstVersion=4.7
 
   | FirstVersion=4.7
 
   | Copyright=''2009'' Florian Forster
 
   | Copyright=''2009'' Florian Forster
Line 8: Line 9:
 
   | Manpage=''collectd.conf(5)''<br />[http://collectd.org/documentation/manpages/collectd-java.5.shtml collectd-java(5)]
 
   | Manpage=''collectd.conf(5)''<br />[http://collectd.org/documentation/manpages/collectd-java.5.shtml collectd-java(5)]
 
}}
 
}}
== Description ==
+
The '''Java plugin''' embeds a <em>Java virtual machine</em> (JVM) into <em>collectd</em> and exposes the <em>application programming interface</em> (API) to Java programs. This allows to write own plugins in the popular language, which are then loaded and executed by the daemon without the need to start a new process and JVM every few seconds. Java classes written for the <em>Java</em> plugin are therefore more powerful and efficient than scripts executed by the [[Plugin:Exec|Exec]] plugin.
 
 
The <em>Java</em> plugin embeds a <em>Java virtual machine</em> (JVM) into <em>collectd</em> and exposes the <em>application programming interface</em> (API) to Java programs. This allows to write own plugins in the popular language, which are then loaded and executed by the daemon without the need to start a new process and JVM every few seconds. Java classes written for the <em>Java</em> plugin are therefore more powerful and efficient than scripts executed by the [[Plugin:Exec|Exec]] plugin.
 
  
 
{{Generic Plugin|java}} The programming interface is documented in detail in the [http://collectd.org/documentation/manpages/collectd-java.5.shtml collectd-java(5) manual page].
 
{{Generic Plugin|java}} The programming interface is documented in detail in the [http://collectd.org/documentation/manpages/collectd-java.5.shtml collectd-java(5) manual page].

Revision as of 22:07, 29 August 2009

Java plugin
Type: binding
Callbacks: config, flush, init, log, notification, read, shutdown, write
Status: supported
First version: 4.7
Copyright: 2009 Florian Forster
License: GPLv2
Manpage: collectd.conf(5)
collectd-java(5)
List of Plugins

The Java plugin embeds a Java virtual machine (JVM) into collectd and exposes the application programming interface (API) to Java programs. This allows to write own plugins in the popular language, which are then loaded and executed by the daemon without the need to start a new process and JVM every few seconds. Java classes written for the Java plugin are therefore more powerful and efficient than scripts executed by the Exec plugin.

This plugin is a generic plugin, i.e. it cannot work without configuration, because there is no reasonable default behavior. Please read the Plugin java section of the collectd.conf(5) manual page for an in-depth description of the plugin's configuration. The programming interface is documented in detail in the collectd-java(5) manual page.

The JavaDoc documentation of the API is available.

Synopsis

<Plugin "java">
  JVMArg "-verbose:jni"
  JVMArg "-Djava.class.path=/opt/collectd/lib/collectd/bindings/java"
  LoadPlugin "org.collectd.java.Foobar"
  <Plugin "org.collectd.java.Foobar">
    # To be parsed by the plugin
  </Plugin>
</Plugin>

Dependencies

  • Java Native Interface (JNI) / libjvm

See also