Skip to content

Commit 0e3bf02

Browse files
Merge pull request #215436 from heyams/heya/3.4.2
Update java agent version to 3.4.2
2 parents 3977db0 + e3b6a9d commit 0e3bf02

File tree

4 files changed

+33
-33
lines changed

4 files changed

+33
-33
lines changed

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

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ This section shows you how to download the auto-instrumentation jar file.
3030

3131
#### Download the jar file
3232

33-
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.
33+
Download the [applicationinsights-agent-3.4.2.jar](https://github.com/microsoft/ApplicationInsights-Java/releases/download/3.4.2/applicationinsights-agent-3.4.2.jar) file.
3434

3535
> [!WARNING]
3636
>
@@ -62,7 +62,7 @@ Download the [applicationinsights-agent-3.4.1.jar](https://github.com/microsoft/
6262

6363
#### Point the JVM to the jar file
6464

65-
Add `-javaagent:"path/to/applicationinsights-agent-3.4.1.jar"` to your application's JVM args.
65+
Add `-javaagent:"path/to/applicationinsights-agent-3.4.2.jar"` to your application's JVM args.
6666

6767
> [!TIP]
6868
> 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.1.jar"` to your applicati
8080
APPLICATIONINSIGHTS_CONNECTION_STRING=<Copy connection string from Application Insights Resource Overview>
8181
```
8282

83-
- 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:
83+
- Or you can create a configuration file named `applicationinsights.json`. Place it in the same directory as `applicationinsights-agent-3.4.2.jar` with the following content:
8484

8585
```json
8686
{

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

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -29,18 +29,18 @@ Read the Spring Boot documentation [here](../app/java-in-process-agent.md).
2929
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:
3030

3131
```
32-
JAVA_OPTS="$JAVA_OPTS -javaagent:path/to/applicationinsights-agent-3.4.1.jar"
32+
JAVA_OPTS="$JAVA_OPTS -javaagent:path/to/applicationinsights-agent-3.4.2.jar"
3333
```
3434

3535
### Tomcat installed via download and unzip
3636

3737
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:
3838

3939
```
40-
CATALINA_OPTS="$CATALINA_OPTS -javaagent:path/to/applicationinsights-agent-3.4.1.jar"
40+
CATALINA_OPTS="$CATALINA_OPTS -javaagent:path/to/applicationinsights-agent-3.4.2.jar"
4141
```
4242

43-
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`.
43+
If the file `<tomcat>/bin/setenv.sh` already exists, then modify that file and add `-javaagent:path/to/applicationinsights-agent-3.4.2.jar` to `CATALINA_OPTS`.
4444

4545

4646
## Tomcat 8 (Windows)
@@ -50,36 +50,36 @@ If the file `<tomcat>/bin/setenv.sh` already exists, then modify that file and a
5050
Locate the file `<tomcat>/bin/catalina.bat`. Create a new file in the same directory named `<tomcat>/bin/setenv.bat` with the following content:
5151

5252
```
53-
set CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.4.1.jar
53+
set CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.4.2.jar
5454
```
5555

5656
Quotes aren't necessary, but if you want to include them, the proper placement is:
5757

5858
```
59-
set "CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.4.1.jar"
59+
set "CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.4.2.jar"
6060
```
6161

62-
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`.
62+
If the file `<tomcat>/bin/setenv.bat` already exists, just modify that file and add `-javaagent:path/to/applicationinsights-agent-3.4.2.jar` to `CATALINA_OPTS`.
6363

6464
### Running Tomcat as a Windows service
6565

66-
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.
66+
Locate the file `<tomcat>/bin/tomcat8w.exe`. Run that executable and add `-javaagent:path/to/applicationinsights-agent-3.4.2.jar` to the `Java Options` under the `Java` tab.
6767

6868

6969
## JBoss EAP 7
7070

7171
### Standalone server
7272

73-
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):
73+
Add `-javaagent:path/to/applicationinsights-agent-3.4.2.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):
7474

7575
```java ...
76-
JAVA_OPTS="-javaagent:path/to/applicationinsights-agent-3.4.1.jar -Xms1303m -Xmx1303m ..."
76+
JAVA_OPTS="-javaagent:path/to/applicationinsights-agent-3.4.2.jar -Xms1303m -Xmx1303m ..."
7777
...
7878
```
7979

8080
### Domain server
8181

82-
Add `-javaagent:path/to/applicationinsights-agent-3.4.1.jar` to the existing `jvm-options` in `JBOSS_HOME/domain/configuration/host.xml`:
82+
Add `-javaagent:path/to/applicationinsights-agent-3.4.2.jar` to the existing `jvm-options` in `JBOSS_HOME/domain/configuration/host.xml`:
8383

8484
```xml
8585
...
@@ -89,7 +89,7 @@ Add `-javaagent:path/to/applicationinsights-agent-3.4.1.jar` to the existing `jv
8989
<jvm-options>
9090
<option value="-server"/>
9191
<!--Add Java agent jar file here-->
92-
<option value="-javaagent:path/to/applicationinsights-agent-3.4.1.jar"/>
92+
<option value="-javaagent:path/to/applicationinsights-agent-3.4.2.jar"/>
9393
<option value="-XX:MetaspaceSize=96m"/>
9494
<option value="-XX:MaxMetaspaceSize=256m"/>
9595
</jvm-options>
@@ -129,20 +129,20 @@ Add these lines to `start.ini`
129129

130130
```
131131
--exec
132-
-javaagent:path/to/applicationinsights-agent-3.4.1.jar
132+
-javaagent:path/to/applicationinsights-agent-3.4.2.jar
133133
```
134134

135135

136136
## Payara 5
137137

138-
Add `-javaagent:path/to/applicationinsights-agent-3.4.1.jar` to the existing `jvm-options` in `glassfish/domains/domain1/config/domain.xml`:
138+
Add `-javaagent:path/to/applicationinsights-agent-3.4.2.jar` to the existing `jvm-options` in `glassfish/domains/domain1/config/domain.xml`:
139139

140140
```xml
141141
...
142142
<java-config ...>
143143
<!--Edit the JVM options here-->
144144
<jvm-options>
145-
-javaagent:path/to/applicationinsights-agent-3.4.1.jar>
145+
-javaagent:path/to/applicationinsights-agent-3.4.2.jar>
146146
</jvm-options>
147147
...
148148
</java-config>
@@ -159,7 +159,7 @@ Java and Process Management > Process definition > Java Virtual Machine
159159
```
160160
In "Generic JVM arguments" add the following JVM argument:
161161
```
162-
-javaagent:path/to/applicationinsights-agent-3.4.1.jar
162+
-javaagent:path/to/applicationinsights-agent-3.4.2.jar
163163
```
164164
After that, save and restart the application server.
165165

@@ -168,7 +168,7 @@ After that, save and restart the application server.
168168

169169
Create a new file `jvm.options` in the server directory (for example `<openliberty>/usr/servers/defaultServer`), and add this line:
170170
```
171-
-javaagent:path/to/applicationinsights-agent-3.4.1.jar
171+
-javaagent:path/to/applicationinsights-agent-3.4.2.jar
172172
```
173173

174174
## Others

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

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -32,14 +32,14 @@ You will find more details and additional configuration options below.
3232

3333
## Configuration file path
3434

35-
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`.
35+
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.2.jar`.
3636

3737
You can specify your own configuration file path using either
3838

3939
* `APPLICATIONINSIGHTS_CONFIGURATION_FILE` environment variable, or
4040
* `applicationinsights.configuration.file` Java system property
4141

42-
If you specify a relative path, it will be resolved relative to the directory where `applicationinsights-agent-3.4.1.jar` is located.
42+
If you specify a relative path, it will be resolved relative to the directory where `applicationinsights-agent-3.4.2.jar` is located.
4343

4444
Alternatively, instead of using a configuration file, you can specify the entire _content_ of the json configuration
4545
via the environment variable `APPLICATIONINSIGHTS_CONFIGURATION_CONTENT`.
@@ -62,7 +62,7 @@ You can also set the connection string using the environment variable `APPLICATI
6262

6363
You can also set the connection string by specifying a file to load the connection string from.
6464

65-
If you specify a relative path, it will be resolved relative to the directory where `applicationinsights-agent-3.4.1.jar` is located.
65+
If you specify a relative path, it will be resolved relative to the directory where `applicationinsights-agent-3.4.2.jar` is located.
6666

6767
```json
6868
{
@@ -136,7 +136,7 @@ Furthermore, sampling is trace ID based, to help ensure consistent sampling deci
136136

137137
### Rate-Limited Sampling
138138

139-
Starting from 3.4.1, rate-limited sampling is available, and is now the default.
139+
Starting from 3.4.2, rate-limited sampling is available, and is now the default.
140140

141141
If no sampling has been configured, the default is now rate-limited sampling configured to capture at most
142142
(approximately) 5 requests per second, along with all the dependencies and logs on those requests.
@@ -264,7 +264,7 @@ Starting from version 3.2.0, if you want to set a custom dimension programmatica
264264

265265
## Connection string overrides (preview)
266266

267-
This feature is in preview, starting from 3.4.1.
267+
This feature is in preview, starting from 3.4.2.
268268

269269
Connection string overrides allow you to override the [default connection string](#connection-string), for example:
270270
* Set one connection string for one http path prefix `/myapp1`.
@@ -456,7 +456,7 @@ You can enable code properties (_FileName_, _ClassName_, _MethodName_, _LineNumb
456456
>
457457
> This feature could add a performance overhead.
458458
459-
This feature is in preview, starting from 3.4.1.
459+
This feature is in preview, starting from 3.4.2.
460460

461461
### LoggingLevel
462462

@@ -502,7 +502,7 @@ To disable auto-collection of Micrometer metrics (including Spring Boot Actuator
502502

503503
Literal values in JDBC queries are masked by default in order to avoid accidentally capturing sensitive data.
504504

505-
Starting from 3.4.1, this behavior can be disabled if desired, e.g.
505+
Starting from 3.4.2, this behavior can be disabled if desired, e.g.
506506

507507
```json
508508
{
@@ -520,7 +520,7 @@ Starting from 3.4.1, this behavior can be disabled if desired, e.g.
520520

521521
Literal values in Mongo queries are masked by default in order to avoid accidentally capturing sensitive data.
522522

523-
Starting from 3.4.1, this behavior can be disabled if desired, e.g.
523+
Starting from 3.4.2, this behavior can be disabled if desired, e.g.
524524

525525
```json
526526
{
@@ -798,7 +798,7 @@ and the console, corresponding to this configuration:
798798
`level` can be one of `OFF`, `ERROR`, `WARN`, `INFO`, `DEBUG`, or `TRACE`.
799799

800800
`path` can be an absolute or relative path. Relative paths are resolved against the directory where
801-
`applicationinsights-agent-3.4.1.jar` is located.
801+
`applicationinsights-agent-3.4.2.jar` is located.
802802

803803
`maxSizeMb` is the max size of the log file before it rolls over.
804804

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

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -19,20 +19,20 @@ auto-instrumentation which is provided by the 3.x Java agent.
1919

2020
| 2.x dependency | Action | Remarks |
2121
|----------------|--------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
22-
| `applicationinsights-core` | Update the version to `3.4.1` or later | |
23-
| `applicationinsights-web` | Update the version to `3.4.1` or later, and remove the Application Insights web filter your `web.xml` file. | |
24-
| `applicationinsights-web-auto` | Replace with `3.4.1` or later of `applicationinsights-web` | |
22+
| `applicationinsights-core` | Update the version to `3.4.2` or later | |
23+
| `applicationinsights-web` | Update the version to `3.4.2` or later, and remove the Application Insights web filter your `web.xml` file. | |
24+
| `applicationinsights-web-auto` | Replace with `3.4.2` or later of `applicationinsights-web` | |
2525
| `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. |
2626
| `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. |
2727
| `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. |
28-
| `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. |
28+
| `applicationinsights-spring-boot-starter` | Replace with `3.4.2` 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. |
2929

3030
## Step 2: Add the 3.x Java agent
3131

3232
Add the 3.x Java agent to your JVM command-line args, for example
3333

3434
```
35-
-javaagent:path/to/applicationinsights-agent-3.4.1.jar
35+
-javaagent:path/to/applicationinsights-agent-3.4.2.jar
3636
```
3737

3838
If you were using the Application Insights 2.x Java agent, just replace your existing `-javaagent:...` with the above.

0 commit comments

Comments
 (0)