EPAgent plugins defined in APMIA profile do not start

book

Article ID: 242234

calendar_today

Updated On:

Products

DX Application Performance Management CA Application Performance Management (APM / Wily / Introscope) CA Application Performance Management Agent (APM / Wily / Introscope)

Issue/Introduction

I have defined some EP Agent plugins in the APM Infrastructure Agent profile file but they are not reporting - all that is listed in the log is 

5/17/22 12:58:51 PM EDT [WARN] [IntroscopeAgent.EPAgent] No Usable EPAgent Servers or Plugins configured.

Cause

In order for the APMIA to run a stateless plugin it must have a command and delayInSeconds property defined for it

The following set of definitions is invalid because that property is not set

introscope.epagent.plugins.stateless.names=MIKE,MIKE1,MIKE2
introscope.epagent.stateless.MIKE.command=/APMIA/epaplugins/MIKE.sh
introscope.epagent.stateless.MIKE1.command=/APMIA/epaplugins/MIKE1.sh
introscope.epagent.stateless.MIKE2.command=/APMIA/epaplugins/MIKE2.sh

Environment

Release : 21.3

Component : Introscope

Resolution

Additional logging information is written to the wrapper log however a request has been raised to improve the logging output in a later release

US822966: ER -  EPAgent plugin configuration errors in APMIA hard to diagnose due to inadequate logging.

the correct configuration properties for this example are

introscope.epagent.plugins.stateless.names=MIKE,MIKE1,MIKE2
introscope.epagent.stateless.MIKE.command=/APMIA/epaplugins/MIKE.sh
introscope.epagent.stateless.MIKE.delayInSeconds=15
introscope.epagent.stateless.MIKE1.command=/APMIA/epaplugins/MIKE1.sh

introscope.epagent.stateless.MIKE1.delayInSeconds=15
introscope.epagent.stateless.MIKE2.command=/APMIA/epaplugins/MIKE2.sh

introscope.epagent.stateless.MIKE2.delayInSeconds=15

Additional Information

if the agent is started with these values the all that is reported in the IntrscopeAgent.log is 

5/17/22 12:58:51 PM EDT [WARN] [IntroscopeAgent.EPAgent] No Usable EPAgent Servers or Plugins configured.

no specific information as to what the problem is. There is a message reported in the wrapper though which eludes to the problem

INFO   | jvm 1    | com.wily.introscope.epagent.IllegalConfigurationException: Stateless plugin 'MIKE' must have a schedule or delay configured.

but just reported for one of the defined plugins

if the config is changed so that a delayInSeconds is added for one of the plugins as below

introscope.epagent.plugins.stateless.names=MIKE,MIKE1,MIKE2
introscope.epagent.stateless.MIKE.command=/APMIA/epaplugins/MIKE.sh
introscope.epagent.stateless.MIKE.delayInSeconds=15
introscope.epagent.stateless.MIKE1.command=/APMIA/epaplugins/MIKE1.sh
introscope.epagent.stateless.MIKE2.command=/APMIA/epaplugins/MIKE2.sh

the agent log then no longer issues any WARN but simply starts the one valid plugin - no info at all that the other definitions are invalid

5/17/22 01:00:54 PM EDT [INFO] [IntroscopeAgent.EPAgent MIKE] Starting plugin 'MIKE'.

The wrapper log does still report a problem but again only for the first incorrect plugin definition

INFO   | jvm 1    | com.wily.introscope.epagent.IllegalConfigurationException: Stateless plugin 'MIKE1' must have a schedule or delay configured.