added APM section

Author: JasonFreeberg

articles/app-service/configure-language-java.md

@@ -179,6 +179,36 @@ First, follow the instructions for [granting your app access to Key Vault](app-s
 
 To inject these secrets in your Spring or Tomcat configuration file, use environment variable injection syntax (`${MY_ENV_VAR}`). For Spring configuration files, please see this documentation on [externalized configurations](https://docs.spring.io/spring-boot/docs/current/reference/html/boot-features-external-config.html).
 
+
+## Configure APM platforms
+
+This section shows how to connect Java applications deployed on Azure App Service on Linux with the NewRelic and AppDynamics application performance monitoring (APM) platforms.
+
+### Configure New Relic
+
+1. Create a NewRelic account at [NewRelic.com](https://newrelic.com/signup)
+2. Download the Java agent from NewRelic, it will have a file name similar to *newrelic-java-x.x.x.zip*.
+3. Copy your license key, you'll need it to configure the agent later.
+4. [SSH into your App Service instance](app-service-linux-ssh-support.md) and create a new directory */home/site/wwwroot/apm*.
+5. Upload the unpacked NewRelic Java agent files into a directory under */home/site/wwwroot/apm*. The files for your agent should be in */home/site/wwwroot/apm/newrelic*.
+6. Modify the YAML file at */home/site/wwwroot/apm/newrelic/newrelic.yml* and replace the placeholder license value with your own license key.
+7. In the Azure portal, browse to your application in App Service and create a new Application Setting.
+    - If your app is using **Java SE**, create an environment variable named `JAVA_OPTS` with the value `-javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar`.
+    - If you're using **Tomcat**, create an environment variable named `CATALINA_OPTS` with the value `-javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar`.
+    - If you're using **WildFly**, see the New Relic documentation [here](https://docs.newrelic.com/docs/agents/java-agent/additional-installation/wildfly-version-11-installation-java) for guidance about installing the Java agent and JBoss configuration.
+    - If you already have an environment variable for `JAVA_OPTS` or `CATALINA_OPTS`, append the `javaagent` option to the end of the current value.
+
+### Configure AppDynamics
+
+1. Create an AppDynamics account at [AppDynamics.com](https://www.appdynamics.com/community/register/)
+2. Download the Java agent from the AppDynamics website, the file name will be similar to *AppServerAgent-x.x.x.xxxxx.zip*
+3. [SSH into your App Service instance](app-service-linux-ssh-support.md) and create a new directory */home/site/wwwroot/apm*.
+4. Upload the Java agent files into a directory under */home/site/wwwroot/apm*. The files for your agent should be in */home/site/wwwroot/apm/appdynamics*.
+5. In the Azure portal, browse to your application in App Service and create a new Application Setting.
+    - If you're using **Java SE**, create an environment variable named `JAVA_OPTS` with the value `-javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name>` where `<app-name>` is your App Service name.
+    - If you're using **Tomcat**, create an environment variable named `CATALINA_OPTS` with the value `-javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name>` where `<app-name>` is your App Service name.
+    - If you're using **WildFly**, see the AppDynamics documentation [here](https://docs.appdynamics.com/display/PRO45/JBoss+and+Wildfly+Startup+Settings) for guidance about installing the Java agent and JBoss configuration.
+
 ## Data sources
 
 ### Tomcat

articles/app-service/containers/configure-language-java.md

@@ -239,9 +239,6 @@ To inject these secrets in your Spring or Tomcat configuration file, use environ
 
 This section shows how to connect Java applications deployed on Azure App Service on Linux with the NewRelic and AppDynamics application performance monitoring (APM) platforms.
 
-[Configure New Relic](#configure-new-relic)
-[Configure AppDynamics](#configure-appdynamics)
-
 ### Configure New Relic
 
 1. Create a NewRelic account at [NewRelic.com](https://newrelic.com/signup)