Merge pull request #212399 from heyams/heya/3.4.1

Update java to 3.4.1

Author: prmerger-automator[bot]

articles/azure-monitor/app/java-in-process-agent.md

@@ -30,7 +30,7 @@ This section shows you how to download the auto-instrumentation jar file.
 
 #### Download the jar file
 
-Download the [applicationinsights-agent-3.4.0.jar](https://github.com/microsoft/ApplicationInsights-Java/releases/download/3.4.0/applicationinsights-agent-3.4.0.jar) file.
+Download the [applicationinsights-agent-3.4.1.jar](https://github.com/microsoft/ApplicationInsights-Java/releases/download/3.4.1/applicationinsights-agent-3.4.1.jar) file.
 
 > [!WARNING]
 >
@@ -62,7 +62,7 @@ Download the [applicationinsights-agent-3.4.0.jar](https://github.com/microsoft/
 
 #### Point the JVM to the jar file
 
-Add `-javaagent:"path/to/applicationinsights-agent-3.4.0.jar"` to your application's JVM args.
+Add `-javaagent:"path/to/applicationinsights-agent-3.4.1.jar"` to your application's JVM args.
 
 > [!TIP]
 > For help with configuring your application's JVM args, see [Tips for updating your JVM args](./java-standalone-arguments.md).
@@ -80,7 +80,7 @@ Add `-javaagent:"path/to/applicationinsights-agent-3.4.0.jar"` to your applicati
         APPLICATIONINSIGHTS_CONNECTION_STRING=<Copy connection string from Application Insights Resource Overview>
         ```
 
-   - Or you can create a configuration file named `applicationinsights.json`. Place it in the same directory as `applicationinsights-agent-3.4.0.jar` with the following content:
+   - Or you can create a configuration file named `applicationinsights.json`. Place it in the same directory as `applicationinsights-agent-3.4.1.jar` with the following content:
 
         ```json
         {

articles/azure-monitor/app/java-spring-boot.md

@@ -15,24 +15,24 @@ You can enable the Azure Monitor Application Insights agent for Java by adding a
 
 ### Usual case
 
-Add the JVM arg `-javaagent:"path/to/applicationinsights-agent-3.4.0.jar"` somewhere before `-jar`, for example:
+Add the JVM arg `-javaagent:"path/to/applicationinsights-agent-3.4.1.jar"` somewhere before `-jar`, for example:
 
 ```
-java -javaagent:"path/to/applicationinsights-agent-3.4.0.jar" -jar <myapp.jar>
+java -javaagent:"path/to/applicationinsights-agent-3.4.1.jar" -jar <myapp.jar>
 ```
 
 ### Spring Boot via Docker entry point
 
-If you're using the *exec* form, add the parameter `-javaagent:"path/to/applicationinsights-agent-3.4.0.jar"` to the parameter list somewhere before the `"-jar"` parameter, for example:
+If you're using the *exec* form, add the parameter `-javaagent:"path/to/applicationinsights-agent-3.4.1.jar"` to the parameter list somewhere before the `"-jar"` parameter, for example:
 
 ```
-ENTRYPOINT ["java", "-javaagent:path/to/applicationinsights-agent-3.4.0.jar", "-jar", "<myapp.jar>"]
+ENTRYPOINT ["java", "-javaagent:path/to/applicationinsights-agent-3.4.1.jar", "-jar", "<myapp.jar>"]
 ```
 
-If you're using the *shell* form, add the JVM arg `-javaagent:"path/to/applicationinsights-agent-3.4.0.jar"` somewhere before `-jar`, for example:
+If you're using the *shell* form, add the JVM arg `-javaagent:"path/to/applicationinsights-agent-3.4.1.jar"` somewhere before `-jar`, for example:
 
 ```
-ENTRYPOINT java -javaagent:"path/to/applicationinsights-agent-3.4.0.jar" -jar <myapp.jar>
+ENTRYPOINT java -javaagent:"path/to/applicationinsights-agent-3.4.1.jar" -jar <myapp.jar>
 ```
 
 ## Programmatic configuration
@@ -42,7 +42,7 @@ To use the programmatic configuration and attach the Application Insights agent
 <dependency>
     <groupId>com.microsoft.azure</groupId>
     <artifactId>applicationinsights-runtime-attach</artifactId>
-    <version>3.4.0</version>
+    <version>3.4.1</version>
 </dependency>
 ```
 

articles/azure-monitor/app/java-standalone-arguments.md

@@ -25,18 +25,18 @@ Read the Spring Boot documentation [here](../app/java-in-process-agent.md).
 If you installed Tomcat via `apt-get` or `yum`, then you should have a file `/etc/tomcat8/tomcat8.conf`.  Add this line to the end of that file:
 
 ```
-JAVA_OPTS="$JAVA_OPTS -javaagent:path/to/applicationinsights-agent-3.4.0.jar"
+JAVA_OPTS="$JAVA_OPTS -javaagent:path/to/applicationinsights-agent-3.4.1.jar"
 ```
 
 ### Tomcat installed via download and unzip
 
 If you installed Tomcat via download and unzip from [https://tomcat.apache.org](https://tomcat.apache.org), then you should have a file `<tomcat>/bin/catalina.sh`.  Create a new file in the same directory named `<tomcat>/bin/setenv.sh` with the following content:
 
 ```
-CATALINA_OPTS="$CATALINA_OPTS -javaagent:path/to/applicationinsights-agent-3.4.0.jar"
+CATALINA_OPTS="$CATALINA_OPTS -javaagent:path/to/applicationinsights-agent-3.4.1.jar"
 ```
 
-If the file `<tomcat>/bin/setenv.sh` already exists, then modify that file and add `-javaagent:path/to/applicationinsights-agent-3.4.0.jar` to `CATALINA_OPTS`.
+If the file `<tomcat>/bin/setenv.sh` already exists, then modify that file and add `-javaagent:path/to/applicationinsights-agent-3.4.1.jar` to `CATALINA_OPTS`.
 
 
 ## Tomcat 8 (Windows)
@@ -46,36 +46,36 @@ If the file `<tomcat>/bin/setenv.sh` already exists, then modify that file and a
 Locate the file `<tomcat>/bin/catalina.bat`.  Create a new file in the same directory named `<tomcat>/bin/setenv.bat` with the following content:
 
 ```
-set CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.4.0.jar
+set CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.4.1.jar
 ```
 
 Quotes aren't necessary, but if you want to include them, the proper placement is:
 
 ```
-set "CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.4.0.jar"
+set "CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.4.1.jar"
 ```
 
-If the file `<tomcat>/bin/setenv.bat` already exists, just modify that file and add `-javaagent:path/to/applicationinsights-agent-3.4.0.jar` to `CATALINA_OPTS`.
+If the file `<tomcat>/bin/setenv.bat` already exists, just modify that file and add `-javaagent:path/to/applicationinsights-agent-3.4.1.jar` to `CATALINA_OPTS`.
 
 ### Running Tomcat as a Windows service
 
-Locate the file `<tomcat>/bin/tomcat8w.exe`.  Run that executable and add `-javaagent:path/to/applicationinsights-agent-3.4.0.jar` to the `Java Options` under the `Java` tab.
+Locate the file `<tomcat>/bin/tomcat8w.exe`.  Run that executable and add `-javaagent:path/to/applicationinsights-agent-3.4.1.jar` to the `Java Options` under the `Java` tab.
 
 
 ## JBoss EAP 7
 
 ### Standalone server
 
-Add `-javaagent:path/to/applicationinsights-agent-3.4.0.jar` to the existing `JAVA_OPTS` environment variable in the file `JBOSS_HOME/bin/standalone.conf` (Linux) or `JBOSS_HOME/bin/standalone.conf.bat` (Windows):
+Add `-javaagent:path/to/applicationinsights-agent-3.4.1.jar` to the existing `JAVA_OPTS` environment variable in the file `JBOSS_HOME/bin/standalone.conf` (Linux) or `JBOSS_HOME/bin/standalone.conf.bat` (Windows):
 
 ```java    ...
-    JAVA_OPTS="-javaagent:path/to/applicationinsights-agent-3.4.0.jar -Xms1303m -Xmx1303m ..."
+    JAVA_OPTS="-javaagent:path/to/applicationinsights-agent-3.4.1.jar -Xms1303m -Xmx1303m ..."
     ...
 ```
 
 ### Domain server
 
-Add `-javaagent:path/to/applicationinsights-agent-3.4.0.jar` to the existing `jvm-options` in `JBOSS_HOME/domain/configuration/host.xml`:
+Add `-javaagent:path/to/applicationinsights-agent-3.4.1.jar` to the existing `jvm-options` in `JBOSS_HOME/domain/configuration/host.xml`:
 
 ```xml
 ...
@@ -85,7 +85,7 @@ Add `-javaagent:path/to/applicationinsights-agent-3.4.0.jar` to the existing `jv
         <jvm-options>
             <option value="-server"/>
             <!--Add Java agent jar file here-->
-            <option value="-javaagent:path/to/applicationinsights-agent-3.4.0.jar"/>
+            <option value="-javaagent:path/to/applicationinsights-agent-3.4.1.jar"/>
             <option value="-XX:MetaspaceSize=96m"/>
             <option value="-XX:MaxMetaspaceSize=256m"/>
         </jvm-options>
@@ -125,20 +125,20 @@ Add these lines to `start.ini`
 
 ```
 --exec
--javaagent:path/to/applicationinsights-agent-3.4.0.jar
+-javaagent:path/to/applicationinsights-agent-3.4.1.jar
 ```
 
 
 ## Payara 5
 
-Add `-javaagent:path/to/applicationinsights-agent-3.4.0.jar` to the existing `jvm-options` in `glassfish/domains/domain1/config/domain.xml`:
+Add `-javaagent:path/to/applicationinsights-agent-3.4.1.jar` to the existing `jvm-options` in `glassfish/domains/domain1/config/domain.xml`:
 
 ```xml
 ...
 <java-config ...>
     <!--Edit the JVM options here-->
     <jvm-options>
-        -javaagent:path/to/applicationinsights-agent-3.4.0.jar>
+        -javaagent:path/to/applicationinsights-agent-3.4.1.jar>
     </jvm-options>
         ...
 </java-config>
@@ -155,7 +155,7 @@ Java and Process Management > Process definition >  Java Virtual Machine
 ```
 In "Generic JVM arguments" add the following JVM argument:
 ```
--javaagent:path/to/applicationinsights-agent-3.4.0.jar
+-javaagent:path/to/applicationinsights-agent-3.4.1.jar
 ```
 After that, save and restart the application server.
 
@@ -164,7 +164,7 @@ After that, save and restart the application server.
 
 Create a new file `jvm.options` in the server directory (for example `<openliberty>/usr/servers/defaultServer`), and add this line:
 ```
--javaagent:path/to/applicationinsights-agent-3.4.0.jar
+-javaagent:path/to/applicationinsights-agent-3.4.1.jar
 ```
 
 ## Others

articles/azure-monitor/app/java-standalone-config.md

@@ -32,14 +32,14 @@ You will find more details and additional configuration options below.
 
 ## Configuration file path
 
-By default, Application Insights Java 3.x expects the configuration file to be named `applicationinsights.json`, and to be located in the same directory as `applicationinsights-agent-3.4.0.jar`.
+By default, Application Insights Java 3.x expects the configuration file to be named `applicationinsights.json`, and to be located in the same directory as `applicationinsights-agent-3.4.1.jar`.
 
 You can specify your own configuration file path using either
 
 * `APPLICATIONINSIGHTS_CONFIGURATION_FILE` environment variable, or
 * `applicationinsights.configuration.file` Java system property
 
-If you specify a relative path, it will be resolved relative to the directory where `applicationinsights-agent-3.4.0.jar` is located.
+If you specify a relative path, it will be resolved relative to the directory where `applicationinsights-agent-3.4.1.jar` is located.
 
 Alternatively, instead of using a configuration file, you can specify the entire _content_ of the json configuration
 via the environment variable `APPLICATIONINSIGHTS_CONFIGURATION_CONTENT`.
@@ -62,7 +62,7 @@ You can also set the connection string using the environment variable `APPLICATI
 
 You can also set the connection string by specifying a file to load the connection string from.
 
-If you specify a relative path, it will be resolved relative to the directory where `applicationinsights-agent-3.4.0.jar` is located.
+If you specify a relative path, it will be resolved relative to the directory where `applicationinsights-agent-3.4.1.jar` is located.
 
 ```json
 {
@@ -140,7 +140,7 @@ Furthermore, sampling is trace ID based, to help ensure consistent sampling deci
 
 ### Rate-Limited Sampling
 
-Starting from 3.4.0, rate-limited sampling is available, and is now the default.
+Starting from 3.4.1, rate-limited sampling is available, and is now the default.
 
 If no sampling has been configured, the default is now rate-limited sampling configured to capture at most
 (approximately) 5 requests per second, along with all the dependencies and logs on those requests.
@@ -268,7 +268,7 @@ Starting from version 3.2.0, if you want to set a custom dimension programmatica
 
 ## Connection string overrides (preview)
 
-This feature is in preview, starting from 3.4.0.
+This feature is in preview, starting from 3.4.1.
 
 Connection string overrides allow you to override the [default connection string](#connection-string), for example:
 * Set one connection string for one http path prefix `/myapp1`.
@@ -437,7 +437,7 @@ You can enable code properties (_FileName_, _ClassName_, _MethodName_, _LineNumb
 >
 > This feature could add a performance overhead.
 
-This feature is in preview, starting from 3.4.0.
+This feature is in preview, starting from 3.4.1.
 
 ### LoggingLevel
 
@@ -483,7 +483,7 @@ To disable auto-collection of Micrometer metrics (including Spring Boot Actuator
 
 Literal values in JDBC queries are masked by default in order to avoid accidentally capturing sensitive data.
 
-Starting from 3.4.0, this behavior can be disabled if desired, e.g.
+Starting from 3.4.1, this behavior can be disabled if desired, e.g.
 
 ```json
 {
@@ -501,7 +501,7 @@ Starting from 3.4.0, this behavior can be disabled if desired, e.g.
 
 Literal values in Mongo queries are masked by default in order to avoid accidentally capturing sensitive data.
 
-Starting from 3.4.0, this behavior can be disabled if desired, e.g.
+Starting from 3.4.1, this behavior can be disabled if desired, e.g.
 
 ```json
 {
@@ -776,7 +776,7 @@ and the console, corresponding to this configuration:
 `level` can be one of `OFF`, `ERROR`, `WARN`, `INFO`, `DEBUG`, or `TRACE`.
 
 `path` can be an absolute or relative path. Relative paths are resolved against the directory where
-`applicationinsights-agent-3.4.0.jar` is located.
+`applicationinsights-agent-3.4.1.jar` is located.
 
 `maxSizeMb` is the max size of the log file before it rolls over.
 

articles/azure-monitor/app/java-standalone-sampling-overrides.md

@@ -48,14 +48,14 @@ To begin, create a configuration file named *applicationinsights.json*. Save it
     "sampling": {
       "overrides": [
         {
-          "telemetryKind": "request",
+          "telemetryType": "request",
           "attributes": [
             ...
           ],
           "percentage": 0
         },
         {
-          "telemetryKind": "request",
+          "telemetryType": "request",
           "attributes": [
             ...
           ],
@@ -69,7 +69,7 @@ To begin, create a configuration file named *applicationinsights.json*. Save it
 
 ## How it works
 
-`telemetryKind` must be one of `request`, `dependency`, `trace` (log), or `exception`.
+`telemetryType` must be one of `request`, `dependency`, `trace` (log), or `exception`.
 
 When a span is started, the type of span and the attributes present on it at that time are used to check if any of the sampling
 overrides match.
@@ -104,7 +104,7 @@ This will also suppress collecting any downstream spans (dependencies) that woul
     "sampling": {
       "overrides": [
         {
-          "telemetryKind": "request",
+          "telemetryType": "request",
           "attributes": [
             {
               "key": "http.url",
@@ -131,7 +131,7 @@ This will suppress collecting telemetry for all `GET my-noisy-key` redis calls.
     "sampling": {
       "overrides": [
         {
-          "telemetryKind": "dependency",
+          "telemetryType": "dependency",
           "attributes": [
             {
               "key": "db.system",
@@ -170,7 +170,7 @@ those will also be collected for all '/login' requests.
     "sampling": {
       "overrides": [
         {
-          "telemetryKind": "request",
+          "telemetryType": "request",
           "attributes": [
             {
               "key": "http.url",

articles/azure-monitor/app/java-standalone-upgrade-from-2x.md

@@ -19,20 +19,20 @@ auto-instrumentation which is provided by the 3.x Java agent.
 
 | 2.x dependency | Action | Remarks                                                                                                                                                                                     |
 |----------------|--------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `applicationinsights-core` | Update the version to `3.4.0` or later |                                                                                                                                                                                             |
-| `applicationinsights-web` | Update the version to `3.4.0` or later, and remove the Application Insights web filter your `web.xml` file. |                                                                                                                                                                                             |
-| `applicationinsights-web-auto` | Replace with `3.4.0` or later of `applicationinsights-web` |                                                                                                                                                                                             |
+| `applicationinsights-core` | Update the version to `3.4.1` or later |                                                                                                                                                                                             |
+| `applicationinsights-web` | Update the version to `3.4.1` or later, and remove the Application Insights web filter your `web.xml` file. |                                                                                                                                                                                             |
+| `applicationinsights-web-auto` | Replace with `3.4.1` or later of `applicationinsights-web` |                                                                                                                                                                                             |
 | `applicationinsights-logging-log4j1_2` | Remove the dependency and remove the Application Insights appender from your log4j configuration. | No longer needed since Log4j 1.2 is auto-instrumented in the 3.x Java agent.                                                                                                                |
 | `applicationinsights-logging-log4j2` | Remove the dependency and remove the Application Insights appender from your log4j configuration. | No longer needed since Log4j 2 is auto-instrumented in the 3.x Java agent.                                                                                                                  |
 | `applicationinsights-logging-log4j1_2` | Remove the dependency and remove the Application Insights appender from your logback configuration. | No longer needed since Logback is auto-instrumented in the 3.x Java agent.                                                                                                                  |
-| `applicationinsights-spring-boot-starter` | Replace with `3.4.0` or later of `applicationinsights-web` | The cloud role name will no longer default to `spring.application.name`, see the [3.x configuration docs](./java-standalone-config.md#cloud-role-name) for configuring the cloud role name. |
+| `applicationinsights-spring-boot-starter` | Replace with `3.4.1` or later of `applicationinsights-web` | The cloud role name will no longer default to `spring.application.name`, see the [3.x configuration docs](./java-standalone-config.md#cloud-role-name) for configuring the cloud role name. |
 
 ## Step 2: Add the 3.x Java agent
 
 Add the 3.x Java agent to your JVM command-line args, for example
 
 ```
--javaagent:path/to/applicationinsights-agent-3.4.0.jar
+-javaagent:path/to/applicationinsights-agent-3.4.1.jar
 ```
 
 If you were using the Application Insights 2.x Java agent, just replace your existing `-javaagent:...` with the above.