Skip to content
CA Application Performance Management - 10.2
Documentation powered by DocOps

Add and Configure EPAgent Plug-ins

Last update July 6, 2017

To run the EPAgent with the default plug-ins, uncomment certain properties in the IntroscopeEPAgent.properties file.

You can change the configuration of the plug-ins. For example, you can remove default plug-ins, or can add new plug-ins.

EPAgent plug-ins are separated into two sections in the IntroscopeEPAgent.properties file, stateful, and stateless.

Add Stateful Plug-ins

Plug-ins that are used by the EPAgent are configured in the IntroscopeEPAgent.properties file.

Follow these steps:

  1. Open the <EPAgent_Home>/epagent/IntroscopeEPAgent.properties file.
  2. Uncomment the property introscope.epagent.plugins.stateful.names,and add the stateful plug-in names that are separated by commas. For example:

    introscope.epagent.plugins.stateful.names=APACHE,WEBLOGIC,WEBSPHERE,IIS

  3. For each stateful plug-in name added in Step 2, add a line that specifies the full command that is required to launch the plug-in. 
    Note: Include any command-line arguments. 
  4. Save the file, and restart the EPAgent.

Use the default properties in the file by uncommenting them. Include the full command line that is required to launch the plug-in. For example, the stateful names property example from Step 2 requires four lines:

introscope.epagent.stateful.APACHE.command=/usr/bin/perl <EPAgent_Home>/epagent/epaplugins/apache/apacheLogReader.pl
introscope.epagent.stateful.WEBLOGIC.command=/usr/bin/perl <EPAgent_Home>/epagent/epaplugins/weblogic/weblogicLogReader.pl
introscope.epagent.stateful.WEBSPHERE.command=/usr/bin/perl <EPAgent_Home>/epagent/epaplugins/websphere/websphereLogReader.pl
introscope.epagent.stateful.IIS.command=/usr/bin/perl <EPAgent_Home>/epagent/epaplugins/iis/iisLogReader.pl


When adding the path in Windows, use the following format:

introscope.epagent.stateful.TEST.command=perl c:\\mydirectory\\myscript.pl

Add Stateless Plug-ins

You can add stateless plug-ins.

Follow these steps:

  1. Open the file <EPAgent_Home>/epagent/IntroscopeEPAgent.properties.
  2. In the property introscope.epagent.plugins.stateless.names, uncomment the property. Add the logical names for the stateless plug-ins, and separate the names by commas. For example:

    introscope.epagent.plugins.stateless.names=DISK,ORACLE,HTTP,KSTAT

  3. For each stateless plug-in name added in the previous step, add two more lines specifying:
    • The full command line that is required to launch the stateless plug-in. Include any command-line arguments with the following syntax: For more information, see EPAgent Default Plug-ins.

      introscope.epagent.plugins.stateless.<pluginname>.command= <command>

    • The frequency that the EPAgent runs the plug-in, as a delay in seconds, with the following syntax:

      introscope.epagent.stateless.<pluginname>.delayInSeconds=<value in seconds>

      For example:

      introscope.epagent.stateless.DISK.command=/usr/bin/perl <EPAgent_Home>/epagent/epaplugins/solaris/diskStats.pl 
      introscope.epagent.stateless.DISK.delayInSeconds=900 
      introscope.epagent.stateless.ORACLE.command=/usr/bin/perl <EPAgent_Home>/epagent/solaris/processAvailability.pl 
      introscope.epagent.stateless.ORACLE.delayInSeconds=900 
      introscope.epagent.stateless.HTTP.command=/usr/bin/perl <EPAgent_Home>/epaplugins/solaris/httpSvcAvailability.pl 
      introscope.epagent.stateless.HTTP.delayInSeconds=900 
      introscope.epagent.stateless.KSTAT.command=/usr/bin/perl <EPAgent_Home>/epaplugins/solaris/kstat.pl 
      introscope.epagent.stateless.KSTAT.delayInSeconds=900

  4. Save changes and restart the EPAgent.

Remove Stateful and Stateless Plug-ins

You can remove plug-ins.

Follow these steps:

  1. Open the <EPAgent_Home>/epagent/IntroscopeEPAgent.properties file.
  2. Delete the names of plug-ins to remove in the introscope.epagent.plugins.stateful.names and introscope.epagent.plugins.stateless.names properties.
  3. Either comment out or delete any command lines that are associated with the plug-ins you are removing.
  4. Save changes and restart the EPAgent.

Configure Java Class Plug-ins

To configure a plug-in that is a Java class that is executed within the EPAgent JVM, configure these properties in the EPAgent properties file:

introscope.epagent.stateful.JAVA-CLASS.class=my.package.path.Class arg1 arg2 arg3


Supply the fully qualified class name followed by any optional arguments. For example:

introscope.epagent.plugins.stateful.names=add
introscope.epagent.stateful.add.class=com.wily.math.Add 1 2

Was this helpful?

Please log in to post comments.