Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info

If you are using inspectIT version 1.6.7 and below, please navigate to [DEPRECATED] Configuration using configuration file(s).

Basic concepts

Complete configuration for all the agents is saved on the server (CMR) component of the inspectIT. The configuration is managed via the user interface Configuration Interface perspective.

Brief overview of the configuration elements

There are three main elements that are used to define the complete configuration:

ElementDescriptionConfiguration
Profile
  • defines on which classes/methods should specific sensors be applied
  • defines exclude rules
Link
Profile configuration
Environment
  • holds basic settings for the agent (sending strategy, buffer strategy, sensor options, etc.)
  • defines which profiles will be used in the given environment
Link
Environment configuration
Agent Mappings
  • maps single (or multiple) agents to one environment 
Link
Agent mappings configuration

Profiles can be used in many environments, while environments can include multiple profiles. This n:m relationships enables easy separation of the configuration and easier management. One environment can be assigned to one or more mappings. Thus, many agents can use the same environment easily. In addition, mappings enable easy switching of the environments for the agent. 

Process of applying configuration and instrumentation

When the agent is started, it reads the repository information and the agent name from the JVM parameters (see Installation Guide and Setting the repository and agent name via JVM parameters). The agent then tries to registers itself with the given repository. If the repository is available and registration is successful agent will receive the configuration from the server that includes basic options and active sensors with their properties. Note that registration will be successful only if there is exactly and only one environment mapped for this agent in the configuration interface. Any change in the configuration requires agent restart, so that updated configuration can be sent to the agent.

...

To decrease the amount of calls to the server during class loading, the agent will keep information about all the classes already sent to the server. This information will be used on every successive agent restart, so the agent will not send any class that is already sent, except in case when the byte-code of the class has changed. More on this you can read in the Sent classes cache page page