Skip to content

Commit f1fab04

Browse files
Merge pull request #217296 from heyams/heya/3.4.3
Release 3.4.3
2 parents 6ee7d98 + 149450a commit f1fab04

File tree

5 files changed

+37
-37
lines changed

5 files changed

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

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

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

65-
Add `-javaagent:"path/to/applicationinsights-agent-3.4.2.jar"` to your application's JVM args.
65+
Add `-javaagent:"path/to/applicationinsights-agent-3.4.3.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.2.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.2.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.3.jar` with the following content:
8484

8585
```json
8686
{

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

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -13,24 +13,24 @@ There are two options for enabling Application Insights Java with Spring Boot: J
1313

1414
## Enabling with JVM argument
1515

16-
Add the JVM arg `-javaagent:"path/to/applicationinsights-agent-3.4.2.jar"` somewhere before `-jar`, for example:
16+
Add the JVM arg `-javaagent:"path/to/applicationinsights-agent-3.4.3.jar"` somewhere before `-jar`, for example:
1717

1818
```
19-
java -javaagent:"path/to/applicationinsights-agent-3.4.2.jar" -jar <myapp.jar>
19+
java -javaagent:"path/to/applicationinsights-agent-3.4.3.jar" -jar <myapp.jar>
2020
```
2121

2222
### Spring Boot via Docker entry point
2323

24-
If you're using the *exec* form, add the parameter `-javaagent:"path/to/applicationinsights-agent-3.4.2.jar"` to the parameter list somewhere before the `"-jar"` parameter, for example:
24+
If you're using the *exec* form, add the parameter `-javaagent:"path/to/applicationinsights-agent-3.4.3.jar"` to the parameter list somewhere before the `"-jar"` parameter, for example:
2525

2626
```
27-
ENTRYPOINT ["java", "-javaagent:path/to/applicationinsights-agent-3.4.2.jar", "-jar", "<myapp.jar>"]
27+
ENTRYPOINT ["java", "-javaagent:path/to/applicationinsights-agent-3.4.3.jar", "-jar", "<myapp.jar>"]
2828
```
2929

30-
If you're using the *shell* form, add the JVM arg `-javaagent:"path/to/applicationinsights-agent-3.4.2.jar"` somewhere before `-jar`, for example:
30+
If you're using the *shell* form, add the JVM arg `-javaagent:"path/to/applicationinsights-agent-3.4.3.jar"` somewhere before `-jar`, for example:
3131

3232
```
33-
ENTRYPOINT java -javaagent:"path/to/applicationinsights-agent-3.4.2.jar" -jar <myapp.jar>
33+
ENTRYPOINT java -javaagent:"path/to/applicationinsights-agent-3.4.3.jar" -jar <myapp.jar>
3434
```
3535

3636
### Configuration
@@ -45,7 +45,7 @@ To enable Application Insights Java programmatically, you must add the following
4545
<dependency>
4646
<groupId>com.microsoft.azure</groupId>
4747
<artifactId>applicationinsights-runtime-attach</artifactId>
48-
<version>3.4.2</version>
48+
<version>3.4.3</version>
4949
</dependency>
5050
```
5151

@@ -87,7 +87,7 @@ as the JVM argument enablement, with the following differences below.
8787
By default, when enabling Application Insights Java programmatically, the configuration file `applicationinsights.json`
8888
will be read from the classpath (`src/main/resources`, `src/test/resources`).
8989

90-
From 3.4.2, you can configure the name of a JSON file in the classpath with the `applicationinsights.runtime-attach.configuration.classpath.file` system property.
90+
From 3.4.3, you can configure the name of a JSON file in the classpath with the `applicationinsights.runtime-attach.configuration.classpath.file` system property.
9191
For example, with `-Dapplicationinsights.runtime-attach.configuration.classpath.file=applicationinsights-dev.json`, Application Insights will use `applicationinsights-dev.json` file for configuration.
9292

9393
> [!NOTE]

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.2.jar"
32+
JAVA_OPTS="$JAVA_OPTS -javaagent:path/to/applicationinsights-agent-3.4.3.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.2.jar"
40+
CATALINA_OPTS="$CATALINA_OPTS -javaagent:path/to/applicationinsights-agent-3.4.3.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.2.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.3.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.2.jar
53+
set CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.4.3.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.2.jar"
59+
set "CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.4.3.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.2.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.3.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.2.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.3.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.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):
73+
Add `-javaagent:path/to/applicationinsights-agent-3.4.3.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.2.jar -Xms1303m -Xmx1303m ..."
76+
JAVA_OPTS="-javaagent:path/to/applicationinsights-agent-3.4.3.jar -Xms1303m -Xmx1303m ..."
7777
...
7878
```
7979

8080
### Domain server
8181

82-
Add `-javaagent:path/to/applicationinsights-agent-3.4.2.jar` to the existing `jvm-options` in `JBOSS_HOME/domain/configuration/host.xml`:
82+
Add `-javaagent:path/to/applicationinsights-agent-3.4.3.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.2.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.2.jar"/>
92+
<option value="-javaagent:path/to/applicationinsights-agent-3.4.3.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.2.jar
132+
-javaagent:path/to/applicationinsights-agent-3.4.3.jar
133133
```
134134

135135

136136
## Payara 5
137137

138-
Add `-javaagent:path/to/applicationinsights-agent-3.4.2.jar` to the existing `jvm-options` in `glassfish/domains/domain1/config/domain.xml`:
138+
Add `-javaagent:path/to/applicationinsights-agent-3.4.3.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.2.jar>
145+
-javaagent:path/to/applicationinsights-agent-3.4.3.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.2.jar
162+
-javaagent:path/to/applicationinsights-agent-3.4.3.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.2.jar
171+
-javaagent:path/to/applicationinsights-agent-3.4.3.jar
172172
```
173173

174174
## Others

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

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -31,14 +31,14 @@ You'll find more information and configuration options in the following sections
3131

3232
## Configuration file path
3333

34-
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`.
34+
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.3.jar`.
3535

3636
You can specify your own configuration file path by using one of these two options:
3737

3838
* `APPLICATIONINSIGHTS_CONFIGURATION_FILE` environment variable
3939
* `applicationinsights.configuration.file` Java system property
4040

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

4343
Alternatively, instead of using a configuration file, you can specify the entire _content_ of the JSON configuration via the environment variable `APPLICATIONINSIGHTS_CONFIGURATION_CONTENT`.
4444

@@ -61,7 +61,7 @@ Or you can set the connection string by using the Java system property `applicat
6161

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

64-
If you specify a relative path, it's resolved relative to the directory where `applicationinsights-agent-3.4.2.jar` is located.
64+
If you specify a relative path, it's resolved relative to the directory where `applicationinsights-agent-3.4.3.jar` is located.
6565

6666
```json
6767
{
@@ -413,7 +413,7 @@ Starting from 3.4.2, you can capture the log markers for Logback and Log4j 2:
413413
414414
### Additional log attributes for Logback (preview)
415415

416-
Starting from 3.4.2, you can capture `FileName`, `ClassName`, `MethodName`, and `LineNumber`, for Logback:
416+
Starting from 3.4.3, you can capture `FileName`, `ClassName`, `MethodName`, and `LineNumber`, for Logback:
417417

418418
```json
419419
{
@@ -752,7 +752,7 @@ In the preceding configuration example:
752752

753753
* `level` can be one of `OFF`, `ERROR`, `WARN`, `INFO`, `DEBUG`, or `TRACE`.
754754
* `path` can be an absolute or relative path. Relative paths are resolved against the directory where
755-
`applicationinsights-agent-3.4.2.jar` is located.
755+
`applicationinsights-agent-3.4.3.jar` is located.
756756

757757
Starting from version 3.0.2, you can also set the self-diagnostics `level` by using the environment variable
758758
`APPLICATIONINSIGHTS_SELF_DIAGNOSTICS_LEVEL`. It then takes precedence over the self-diagnostics level specified in the JSON configuration.

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.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` | |
22+
| `applicationinsights-core` | Update the version to `3.4.3` or later | |
23+
| `applicationinsights-web` | Update the version to `3.4.3` or later, and remove the Application Insights web filter your `web.xml` file. | |
24+
| `applicationinsights-web-auto` | Replace with `3.4.3` 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.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. |
28+
| `applicationinsights-spring-boot-starter` | Replace with `3.4.3` 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.2.jar
35+
-javaagent:path/to/applicationinsights-agent-3.4.3.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)