Skip to content

Commit f07a142

Browse files
authored
Merge pull request #183525 from kryalama/kryalama/updateversions
Update 2.x and 3.x versions in docs
2 parents 7ec4117 + 0f8d55b commit f07a142

File tree

6 files changed

+35
-35
lines changed

6 files changed

+35
-35
lines changed

articles/azure-monitor/app/java-2x-agent.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ If you have [instrumented your Java web app with Application Insights SDK][java]
3434
To use the Java agent, you install it on your server. Your web apps must be instrumented with the [Application Insights Java SDK][java].
3535

3636
## Install the Application Insights agent for Java
37-
1. On the machine running your Java server, [download the 2.x agent](https://github.com/microsoft/ApplicationInsights-Java/releases/tag/2.6.2). Please make sure the version of the 2.x Java Agent that you use matches the version of the 2.x Application Insights Java SDK that you use.
37+
1. On the machine running your Java server, [download the 2.x agent](https://github.com/microsoft/ApplicationInsights-Java/releases/tag/2.6.4). Please make sure the version of the 2.x Java Agent that you use matches the version of the 2.x Application Insights Java SDK that you use.
3838
2. Edit the application server startup script, and add the following JVM argument:
3939

4040
`-javaagent:<full path to the agent JAR file>`
@@ -87,7 +87,7 @@ For Azure App Services, do the following:
8787
* Under App Settings, add a new key value pair:
8888

8989
Key: `JAVA_OPTS`
90-
Value: `-javaagent:D:/home/site/wwwroot/applicationinsights-agent-2.6.2.jar`
90+
Value: `-javaagent:D:/home/site/wwwroot/applicationinsights-agent-2.6.4.jar`
9191

9292
The agent must be packaged as a resource in your project such that it ends up in the D:/home/site/wwwroot/ directory. You can confirm that your agent is in the correct App Service directory by going to **Development Tools** > **Advanced Tools** > **Debug Console** and examining the contents of the site directory.
9393

articles/azure-monitor/app/java-2x-get-started.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ Then, refresh the project dependencies to get the binaries downloaded.
5252
<artifactId>applicationinsights-web-auto</artifactId>
5353
<!-- or applicationinsights-web for manual web filter registration -->
5454
<!-- or applicationinsights-core for bare API -->
55-
<version>2.6.2</version>
55+
<version>2.6.4</version>
5656
</dependency>
5757
</dependencies>
5858
```
@@ -65,7 +65,7 @@ Then refresh the project dependencies to get the binaries downloaded.
6565

6666
```gradle
6767
dependencies {
68-
compile group: 'com.microsoft.azure', name: 'applicationinsights-web-auto', version: '2.6.2'
68+
compile group: 'com.microsoft.azure', name: 'applicationinsights-web-auto', version: '2.6.4'
6969
// or applicationinsights-web for manual web filter registration
7070
// or applicationinsights-core for bare API
7171
}

articles/azure-monitor/app/java-2x-troubleshoot.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Questions or problems with [Azure Application Insights in Java][java]? Here are
2020
## Build errors
2121
**In Eclipse or Intellij Idea, when adding the Application Insights SDK via Maven or Gradle, I get build or checksum validation errors.**
2222

23-
* If the dependency `<version>` element is using a pattern with wildcard characters (e.g. (Maven) `<version>[2.0,)</version>` or (Gradle) `version:'2.+'`), try specifying a specific version instead like `2.6.2`.
23+
* If the dependency `<version>` element is using a pattern with wildcard characters (e.g. (Maven) `<version>[2.0,)</version>` or (Gradle) `version:'2.+'`), try specifying a specific version instead like `2.6.4`.
2424

2525
## No data
2626
**I added Application Insights successfully and ran my app, but I've never seen data in the portal.**

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

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

2929
#### Download the jar file
3030

31-
Download the [applicationinsights-agent-3.2.3.jar](https://github.com/microsoft/ApplicationInsights-Java/releases/download/3.2.3/applicationinsights-agent-3.2.3.jar) file.
31+
Download the [applicationinsights-agent-3.2.4.jar](https://github.com/microsoft/ApplicationInsights-Java/releases/download/3.2.4/applicationinsights-agent-3.2.4.jar) file.
3232

3333
> [!WARNING]
3434
>
@@ -50,7 +50,7 @@ Download the [applicationinsights-agent-3.2.3.jar](https://github.com/microsoft/
5050
5151
#### Point the JVM to the jar file
5252

53-
Add `-javaagent:path/to/applicationinsights-agent-3.2.3.jar` to your application's JVM args.
53+
Add `-javaagent:path/to/applicationinsights-agent-3.2.4.jar` to your application's JVM args.
5454

5555
> [!TIP]
5656
> For help with configuring your application's JVM args, see [Tips for updating your JVM args](./java-standalone-arguments.md).
@@ -65,7 +65,7 @@ Add `-javaagent:path/to/applicationinsights-agent-3.2.3.jar` to your application
6565
APPLICATIONINSIGHTS_CONNECTION_STRING=InstrumentationKey=...
6666
```
6767

68-
- Or you can create a configuration file named `applicationinsights.json`. Place it in the same directory as `applicationinsights-agent-3.2.3.jar` with the following content:
68+
- Or you can create a configuration file named `applicationinsights.json`. Place it in the same directory as `applicationinsights-agent-3.2.4.jar` with the following content:
6969

7070
```json
7171
{
@@ -357,13 +357,13 @@ If you want to attach custom dimensions to your logs, use [Log4j 1.2 MDC](https:
357357

358358
### Send custom telemetry by using the 2.x SDK
359359

360-
1. Add `applicationinsights-core-2.6.3.jar` to your application. All 2.x versions are supported by Application Insights Java 3.x. If you have a choice. it's worth using the latest version:
360+
1. Add `applicationinsights-core-2.6.4.jar` to your application. All 2.x versions are supported by Application Insights Java 3.x. If you have a choice. it's worth using the latest version:
361361

362362
```xml
363363
<dependency>
364364
<groupId>com.microsoft.azure</groupId>
365365
<artifactId>applicationinsights-core</artifactId>
366-
<version>2.6.3</version>
366+
<version>2.6.4</version>
367367
</dependency>
368368
```
369369

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

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -16,24 +16,24 @@ Configure [App Services](../../app-service/configure-language-java.md#set-java-r
1616

1717
## Spring Boot
1818

19-
Add the JVM arg `-javaagent:path/to/applicationinsights-agent-3.2.3.jar` somewhere before `-jar`, for example:
19+
Add the JVM arg `-javaagent:path/to/applicationinsights-agent-3.2.4.jar` somewhere before `-jar`, for example:
2020

2121
```
22-
java -javaagent:path/to/applicationinsights-agent-3.2.3.jar -jar <myapp.jar>
22+
java -javaagent:path/to/applicationinsights-agent-3.2.4.jar -jar <myapp.jar>
2323
```
2424

2525
## Spring Boot via Docker entry point
2626

27-
If you are using the *exec* form, add the parameter `"-javaagent:path/to/applicationinsights-agent-3.2.3.jar"` to the parameter list somewhere before the `"-jar"` parameter, for example:
27+
If you are using the *exec* form, add the parameter `"-javaagent:path/to/applicationinsights-agent-3.2.4.jar"` to the parameter list somewhere before the `"-jar"` parameter, for example:
2828

2929
```
30-
ENTRYPOINT ["java", "-javaagent:path/to/applicationinsights-agent-3.2.3.jar", "-jar", "<myapp.jar>"]
30+
ENTRYPOINT ["java", "-javaagent:path/to/applicationinsights-agent-3.2.4.jar", "-jar", "<myapp.jar>"]
3131
```
3232

33-
If you are using the *shell* form, add the JVM arg `-javaagent:path/to/applicationinsights-agent-3.2.3.jar` somewhere before `-jar`, for example:
33+
If you are using the *shell* form, add the JVM arg `-javaagent:path/to/applicationinsights-agent-3.2.4.jar` somewhere before `-jar`, for example:
3434

3535
```
36-
ENTRYPOINT java -javaagent:path/to/applicationinsights-agent-3.2.3.jar -jar <myapp.jar>
36+
ENTRYPOINT java -javaagent:path/to/applicationinsights-agent-3.2.4.jar -jar <myapp.jar>
3737
```
3838

3939
## Tomcat 8 (Linux)
@@ -43,18 +43,18 @@ ENTRYPOINT java -javaagent:path/to/applicationinsights-agent-3.2.3.jar -jar <mya
4343
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:
4444

4545
```
46-
JAVA_OPTS="$JAVA_OPTS -javaagent:path/to/applicationinsights-agent-3.2.3.jar"
46+
JAVA_OPTS="$JAVA_OPTS -javaagent:path/to/applicationinsights-agent-3.2.4.jar"
4747
```
4848

4949
### Tomcat installed via download and unzip
5050

5151
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:
5252

5353
```
54-
CATALINA_OPTS="$CATALINA_OPTS -javaagent:path/to/applicationinsights-agent-3.2.3.jar"
54+
CATALINA_OPTS="$CATALINA_OPTS -javaagent:path/to/applicationinsights-agent-3.2.4.jar"
5555
```
5656

57-
If the file `<tomcat>/bin/setenv.sh` already exists, then modify that file and add `-javaagent:path/to/applicationinsights-agent-3.2.3.jar` to `CATALINA_OPTS`.
57+
If the file `<tomcat>/bin/setenv.sh` already exists, then modify that file and add `-javaagent:path/to/applicationinsights-agent-3.2.4.jar` to `CATALINA_OPTS`.
5858

5959

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

6666
```
67-
set CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.2.3.jar
67+
set CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.2.4.jar
6868
```
6969

7070
Quotes are not necessary, but if you want to include them, the proper placement is:
7171

7272
```
73-
set "CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.2.3.jar"
73+
set "CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.2.4.jar"
7474
```
7575

76-
If the file `<tomcat>/bin/setenv.bat` already exists, just modify that file and add `-javaagent:path/to/applicationinsights-agent-3.2.3.jar` to `CATALINA_OPTS`.
76+
If the file `<tomcat>/bin/setenv.bat` already exists, just modify that file and add `-javaagent:path/to/applicationinsights-agent-3.2.4.jar` to `CATALINA_OPTS`.
7777

7878
### Running Tomcat as a Windows service
7979

80-
Locate the file `<tomcat>/bin/tomcat8w.exe`. Run that executable and add `-javaagent:path/to/applicationinsights-agent-3.2.3.jar` to the `Java Options` under the `Java` tab.
80+
Locate the file `<tomcat>/bin/tomcat8w.exe`. Run that executable and add `-javaagent:path/to/applicationinsights-agent-3.2.4.jar` to the `Java Options` under the `Java` tab.
8181

8282

8383
## JBoss EAP 7
8484

8585
### Standalone server
8686

87-
Add `-javaagent:path/to/applicationinsights-agent-3.2.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):
87+
Add `-javaagent:path/to/applicationinsights-agent-3.2.4.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):
8888

8989
```java ...
90-
JAVA_OPTS="-javaagent:path/to/applicationinsights-agent-3.2.3.jar -Xms1303m -Xmx1303m ..."
90+
JAVA_OPTS="-javaagent:path/to/applicationinsights-agent-3.2.4.jar -Xms1303m -Xmx1303m ..."
9191
...
9292
```
9393

9494
### Domain server
9595

96-
Add `-javaagent:path/to/applicationinsights-agent-3.2.3.jar` to the existing `jvm-options` in `JBOSS_HOME/domain/configuration/host.xml`:
96+
Add `-javaagent:path/to/applicationinsights-agent-3.2.4.jar` to the existing `jvm-options` in `JBOSS_HOME/domain/configuration/host.xml`:
9797

9898
```xml
9999
...
@@ -103,7 +103,7 @@ Add `-javaagent:path/to/applicationinsights-agent-3.2.3.jar` to the existing `jv
103103
<jvm-options>
104104
<option value="-server"/>
105105
<!--Add Java agent jar file here-->
106-
<option value="-javaagent:path/to/applicationinsights-agent-3.2.3.jar"/>
106+
<option value="-javaagent:path/to/applicationinsights-agent-3.2.4.jar"/>
107107
<option value="-XX:MetaspaceSize=96m"/>
108108
<option value="-XX:MaxMetaspaceSize=256m"/>
109109
</jvm-options>
@@ -143,20 +143,20 @@ Add these lines to `start.ini`
143143

144144
```
145145
--exec
146-
-javaagent:path/to/applicationinsights-agent-3.2.3.jar
146+
-javaagent:path/to/applicationinsights-agent-3.2.4.jar
147147
```
148148

149149

150150
## Payara 5
151151

152-
Add `-javaagent:path/to/applicationinsights-agent-3.2.3.jar` to the existing `jvm-options` in `glassfish/domains/domain1/config/domain.xml`:
152+
Add `-javaagent:path/to/applicationinsights-agent-3.2.4.jar` to the existing `jvm-options` in `glassfish/domains/domain1/config/domain.xml`:
153153

154154
```xml
155155
...
156156
<java-config ...>
157157
<!--Edit the JVM options here-->
158158
<jvm-options>
159-
-javaagent:path/to/applicationinsights-agent-3.2.3.jar>
159+
-javaagent:path/to/applicationinsights-agent-3.2.4.jar>
160160
</jvm-options>
161161
...
162162
</java-config>
@@ -173,7 +173,7 @@ Java and Process Management > Process definition > Java Virtual Machine
173173
```
174174
In "Generic JVM arguments" add the following:
175175
```
176-
-javaagent:path/to/applicationinsights-agent-3.2.3.jar
176+
-javaagent:path/to/applicationinsights-agent-3.2.4.jar
177177
```
178178
After that, save and restart the application server.
179179

@@ -182,7 +182,7 @@ After that, save and restart the application server.
182182

183183
Create a new file `jvm.options` in the server directory (for example `<openliberty>/usr/servers/defaultServer`), and add this line:
184184
```
185-
-javaagent:path/to/applicationinsights-agent-3.2.3.jar
185+
-javaagent:path/to/applicationinsights-agent-3.2.4.jar
186186
```
187187

188188
## Others

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

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

3737
## Configuration file path
3838

39-
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.2.3.jar`.
39+
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.2.4.jar`.
4040

4141
You can specify your own configuration file path using either
4242

4343
* `APPLICATIONINSIGHTS_CONFIGURATION_FILE` environment variable, or
4444
* `applicationinsights.configuration.file` Java system property
4545

46-
If you specify a relative path, it will be resolved relative to the directory where `applicationinsights-agent-3.2.3.jar` is located.
46+
If you specify a relative path, it will be resolved relative to the directory where `applicationinsights-agent-3.2.4.jar` is located.
4747

4848
## Connection string
4949

@@ -508,7 +508,7 @@ and the console, corresponding to this configuration:
508508
`level` can be one of `OFF`, `ERROR`, `WARN`, `INFO`, `DEBUG`, or `TRACE`.
509509

510510
`path` can be an absolute or relative path. Relative paths are resolved against the directory where
511-
`applicationinsights-agent-3.2.3.jar` is located.
511+
`applicationinsights-agent-3.2.4.jar` is located.
512512

513513
`maxSizeMb` is the max size of the log file before it rolls over.
514514

0 commit comments

Comments
 (0)