Use Custom Installation Method to Deploy Agents

Warning: Your OpenTelemetry data may transit through regions different from where your Controller is hosted, if you configure your OpenTelemetry Collector using a Splunk AppDynamics endpoint located outside of the region, where your Controller is hosted. See Support for Splunk AppDynamics for OpenTelemetry™.
  1. Select Custom Installation.
  2. Select the agents Java Agent(Legacy or JKD8+) or Machine Agent you want to install.
  3. (Optional): Enable OpenTelemetry for Java Agent JDK8+. To do this, add traces exporter, metrics exporter, and OTLP Endpoint.
  4. (Optional): Enable Server Visibility or .NET Compatibility Mode for the Machine Agent.
  5. Copy and run the command into your terminal (on Linux) / PowerShell (on Windows) window or automated tools.
  6. Determine how to run the Agent Installer by setting user permissions:
    On Linux:

    • Select Instrument processes for all system users (requires sudo access) to run the Agent Installer with sudo permission and enable the Agent Installer Platform for all users on the host.

      • By default, the services run as root. To configure the services to run as a different user, add the parameter: --run-as <user> .
      • By default, the processes that run by all users will be instrumented. To instrument processes run by specific users, add the parameter: --filter-by-users <user1>,<user2>, or the parameter: --filter-by-groups <group1>,<group2> .

    • Select Instrument processes for an individual user to run the Agent Installer without sudo permission and enable the Agent Installer Platform for the current user only. See Sudo vs. Non-Sudo Access.

    On Windows:
    • By default the installed services run as the LOCAL SYSTEM. To configure the services to run as a local service account:

      • Add the run-as password

      • If a service account is used (e.g. NT AUTHORITY\LOCAL SERVICE

  7. After confirming the user installation permissions, select script icon(top right corner of the command) to copy and run the command.
    To reveal the full command with your access key, select Show command.
    When you run the command on a designated host, the agent files download onto that host only. To install agents on multiple hosts, select Run the Agent Installer on Multiple Hosts.
  8. Restart the application processes you want to monitor.
  9. Click Next to continue with the instrumentation.
After you finish installing the agents, you are redirected to the Monitoring Settings tab to view instrumented tiers and nodes.