How does APM agent determine its name before it decides to use the default Agent name "UnknownAgent"?

book

Article ID: 18470

calendar_today

Updated On:

Products

APP PERF MANAGEMENT CA Application Performance Management Agent (APM / Wily / Introscope) CUSTOMER EXPERIENCE MANAGER INTROSCOPE

Issue/Introduction

After an APM agent is installed and reporting to an EM, it shows up as "UnknownAgent" in a workstation and the agent log contains:

  • [INFO] [IntroscopeAgent.Agent] Unable to automatically determine the Agent Name because: The Application Server naming mechanism is not yet available.
     
  • [INFO] [IntroscopeAgent.Agent] Unable to automatically determine the Agent name before the connection delay timeout.


    Environment

    APM Agents from 9.7 awards

    Resolution

    The APM Agent will attempt to find a name for itself through the following sequence of methods.

    1. Name Specified in Java system property

      The agent name is defined using a Java system property on the command line.

      Using this method will override any other agent naming method.
       
    2. Name specified in System Property Key in Agent Profile

      The Agent name is obtained from a Java system property specified in the property, "introscope.agent.agentNameSystemPropertyKey" in theIntroscopeAgent.profile.
       
    3. Name obtained automatically from Application Server

      If you are using certain versions of WebLogic or WebSphere, the agent name can be automatically obtained from the application server using new automatic agent naming functionality. You can configure a time delay, to give the agent as much time as necessary to determine its name before connecting to the Enterprise Manager.
       
    4. Name specified explicitly in agent profile

      The agent name is defined in the IntroscopeAgent.profile, in the property, "introscope.agent.agentName". This was the standard method for naming agents in past Introscope versions. Use this option if you already have an agent profile for every application.