[Webinar] Discover key trends and best practices in Kubernetes observability with DevOps expert, Viktor Farcic.Register now
Our recognition in the inaugural Gartner MQ for DEM

Install APM Insight Java Agent in AWS Elastic Beanstalk


  • Create a new directory under <APP_HOME>/WEB-INF/lib, say appmanager.
  • Download latest the APM Insight java agent zip file (apminsight-javaagent.zip) here
  • Extract the zip file to a appmanager directory to find agent jar and its configuration files.
  • Open the apminsight.conf file in any text editor and include the following keys:
    license.key=[LICENSE KEY]
    apm.host=http://[HOST]:[PORT]

    Example:

    license.key=APMI_74447444b666d7ab5174cc3021a9b68dd4b3364d50f99c2969360810313e8fac
    apm.host=http://apm-prod-server:9090

    To learn more about the configurations, visit our Configuration Guide page.

  • Repackage your application and deploy it on AWS Elastic Beanstalk.
  • In AWS Console, go to Elastic Beanstalk and choose your application.
  • Navigate to Configurations > Software Configuration > JVM command line options to add the java argument
    -javaagent:<APP_HOME>/WEB-INF/lib/apminsight-javaagent jar

    Note: Saving the JVM configuration changes will restart the application server automatically.

    Example: For installing agent in Tomcat container on linux, JVM argument would look like:
    -javaagent:/usr/home/tomcat/webapps/ROOT/WEB-INF/lib/appmanager/apminsight-javaagent.jar
Note:
  • You can also configure a secure APM URL. Ensure that the connection is stable and free from certificate-related issues.
    Example: https://apm-prod-server:8443
  • For an Applications Manager failover setup, you can specify multiple hosts in a comma-separated format (supported from Java Agent v6.8), as shown below:
    apm.host=http://apm-prod-server-A:9090, http://apm-prod-server-B:9090
Back to Top