Skip to main content

Auto Instrumentation

The APM agent can automatically scan your servers and virtual machines to find Java applications that are ready to be instrumented. You can turn on monitoring for them with a single click directly from the UI.

Prerequisites​

Before you begin, ensure the following requirements are met:

  • The Motadata Agent must be installed and running on the server where the application is deployed. The otelcol process must also be running as part of the Motadata Agent.

    To check the agent status, open a Linux terminal and run the following command:

    service motadata-agent status
    info

    If the agent is not running, restart it using the following commands:

    service motadata-agent stop
    service motadata-agent start

  • Java version 8 or higher is required. To verify the installed version, run:

    java -version

  • Motadata Agent and application version must be 8.2.5 or higher.

Select Auto Detect as the Instrumentation Method.

Select the Linux or Windows agent for the Host/VM method from the Select Agent list. The Setup Command is displayed — copy it and run it in the CLI of the server where you want to instrument the application.

Once the above steps are applied, the list of discovered applications is displayed.

Click the Configure button in the Action column for the application you want to register.

note

Services with a name starting with unknown_service* cannot be registered. Additionally, if a service with the same name already exists, it cannot be configured again.

Once configured, a registration confirmation is displayed on the screen. Trace collection starts automatically, and the application becomes visible in the APM Explorer.