Skip to content

Commit 6078bd1

Browse files
committed
Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into feedbackUpdate
2 parents da5ec9f + 1578d6b commit 6078bd1

File tree

15 files changed

+582
-82
lines changed

15 files changed

+582
-82
lines changed

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

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Azure Monitor Application Insights Java
33
description: Application performance monitoring for Java applications running in any environment without requiring code modification. The article also discusses distributed tracing and the application map.
44
ms.topic: conceptual
5-
ms.date: 12/14/2022
5+
ms.date: 01/18/2023
66
ms.devlang: java
77
ms.custom: devx-track-java, ignite-2022
88
ms.reviewer: mmcc
@@ -32,7 +32,7 @@ This section shows you how to download the auto-instrumentation jar file.
3232

3333
#### Download the jar file
3434

35-
Download the [applicationinsights-agent-3.4.7.jar](https://github.com/microsoft/ApplicationInsights-Java/releases/download/3.4.7/applicationinsights-agent-3.4.7.jar) file.
35+
Download the [applicationinsights-agent-3.4.8.jar](https://github.com/microsoft/ApplicationInsights-Java/releases/download/3.4.8/applicationinsights-agent-3.4.8.jar) file.
3636

3737
> [!WARNING]
3838
>
@@ -63,7 +63,7 @@ Download the [applicationinsights-agent-3.4.7.jar](https://github.com/microsoft/
6363
6464
#### Point the JVM to the jar file
6565

66-
Add `-javaagent:"path/to/applicationinsights-agent-3.4.7.jar"` to your application's JVM args.
66+
Add `-javaagent:"path/to/applicationinsights-agent-3.4.8.jar"` to your application's JVM args.
6767

6868
> [!TIP]
6969
> For help with configuring your application's JVM args, see [Tips for updating your JVM args](./java-standalone-arguments.md).
@@ -80,7 +80,7 @@ If you develop a Spring Boot application, you can replace the JVM argument by a
8080
APPLICATIONINSIGHTS_CONNECTION_STRING=<Copy connection string from Application Insights Resource Overview>
8181
```
8282

83-
- Create a configuration file named `applicationinsights.json`. Place it in the same directory as `applicationinsights-agent-3.4.7.jar` with the following content:
83+
- Create a configuration file named `applicationinsights.json`. Place it in the same directory as `applicationinsights-agent-3.4.8.jar` with the following content:
8484

8585
```json
8686
{

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

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Configure Azure Monitor Application Insights for Spring Boot
33
description: How to configure Azure Monitor Application Insights for Spring Boot applications
44
ms.topic: conceptual
5-
ms.date: 12/14/2022
5+
ms.date: 01/18/2023
66
ms.devlang: java
77
ms.custom: devx-track-java
88
---
@@ -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.7.jar"` somewhere before `-jar`, for example:
16+
Add the JVM arg `-javaagent:"path/to/applicationinsights-agent-3.4.8.jar"` somewhere before `-jar`, for example:
1717

1818
```
19-
java -javaagent:"path/to/applicationinsights-agent-3.4.7.jar" -jar <myapp.jar>
19+
java -javaagent:"path/to/applicationinsights-agent-3.4.8.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.7.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.8.jar"` to the parameter list somewhere before the `"-jar"` parameter, for example:
2525

2626
```
27-
ENTRYPOINT ["java", "-javaagent:path/to/applicationinsights-agent-3.4.7.jar", "-jar", "<myapp.jar>"]
27+
ENTRYPOINT ["java", "-javaagent:path/to/applicationinsights-agent-3.4.8.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.7.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.8.jar"` somewhere before `-jar`, for example:
3131

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

3636
### Configuration

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

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Add the JVM arg - Application Insights for Java
33
description: Learn how to add the JVM arg that enables Application Insights for Java.
44
ms.topic: conceptual
5-
ms.date: 12/14/2022
5+
ms.date: 01/18/2023
66
ms.devlang: java
77
ms.custom: devx-track-java
88
ms.reviewer: mmcc
@@ -34,18 +34,18 @@ If you're using a third-party container image that you can't modify, mount the A
3434
If you installed Tomcat via `apt-get` or `yum`, you should have a file `/etc/tomcat8/tomcat8.conf`. Add this line to the end of that file:
3535

3636
```
37-
JAVA_OPTS="$JAVA_OPTS -javaagent:path/to/applicationinsights-agent-3.4.7.jar"
37+
JAVA_OPTS="$JAVA_OPTS -javaagent:path/to/applicationinsights-agent-3.4.8.jar"
3838
```
3939

4040
### Tomcat installed via download and unzip
4141

4242
If you installed Tomcat via download and unzip from [https://tomcat.apache.org](https://tomcat.apache.org), 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:
4343

4444
```
45-
CATALINA_OPTS="$CATALINA_OPTS -javaagent:path/to/applicationinsights-agent-3.4.7.jar"
45+
CATALINA_OPTS="$CATALINA_OPTS -javaagent:path/to/applicationinsights-agent-3.4.8.jar"
4646
```
4747

48-
If the file `<tomcat>/bin/setenv.sh` already exists, modify that file and add `-javaagent:path/to/applicationinsights-agent-3.4.7.jar` to `CATALINA_OPTS`.
48+
If the file `<tomcat>/bin/setenv.sh` already exists, modify that file and add `-javaagent:path/to/applicationinsights-agent-3.4.8.jar` to `CATALINA_OPTS`.
4949

5050
## Tomcat 8 (Windows)
5151

@@ -54,35 +54,35 @@ If the file `<tomcat>/bin/setenv.sh` already exists, modify that file and add `-
5454
Locate the file `<tomcat>/bin/catalina.bat`. Create a new file in the same directory named `<tomcat>/bin/setenv.bat` with the following content:
5555

5656
```
57-
set CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.4.7.jar
57+
set CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.4.8.jar
5858
```
5959

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

6262
```
63-
set "CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.4.7.jar"
63+
set "CATALINA_OPTS=%CATALINA_OPTS% -javaagent:path/to/applicationinsights-agent-3.4.8.jar"
6464
```
6565

66-
If the file `<tomcat>/bin/setenv.bat` already exists, modify that file and add `-javaagent:path/to/applicationinsights-agent-3.4.7.jar` to `CATALINA_OPTS`.
66+
If the file `<tomcat>/bin/setenv.bat` already exists, modify that file and add `-javaagent:path/to/applicationinsights-agent-3.4.8.jar` to `CATALINA_OPTS`.
6767

6868
### Run Tomcat as a Windows service
6969

70-
Locate the file `<tomcat>/bin/tomcat8w.exe`. Run that executable and add `-javaagent:path/to/applicationinsights-agent-3.4.7.jar` to the `Java Options` under the `Java` tab.
70+
Locate the file `<tomcat>/bin/tomcat8w.exe`. Run that executable and add `-javaagent:path/to/applicationinsights-agent-3.4.8.jar` to the `Java Options` under the `Java` tab.
7171

7272
## JBoss EAP 7
7373

7474
### Standalone server
7575

76-
Add `-javaagent:path/to/applicationinsights-agent-3.4.7.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):
76+
Add `-javaagent:path/to/applicationinsights-agent-3.4.8.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):
7777

7878
```java ...
79-
JAVA_OPTS="-javaagent:path/to/applicationinsights-agent-3.4.7.jar -Xms1303m -Xmx1303m ..."
79+
JAVA_OPTS="-javaagent:path/to/applicationinsights-agent-3.4.8.jar -Xms1303m -Xmx1303m ..."
8080
...
8181
```
8282

8383
### Domain server
8484

85-
Add `-javaagent:path/to/applicationinsights-agent-3.4.7.jar` to the existing `jvm-options` in `JBOSS_HOME/domain/configuration/host.xml`:
85+
Add `-javaagent:path/to/applicationinsights-agent-3.4.8.jar` to the existing `jvm-options` in `JBOSS_HOME/domain/configuration/host.xml`:
8686

8787
```xml
8888
...
@@ -92,7 +92,7 @@ Add `-javaagent:path/to/applicationinsights-agent-3.4.7.jar` to the existing `jv
9292
<jvm-options>
9393
<option value="-server"/>
9494
<!--Add Java agent jar file here-->
95-
<option value="-javaagent:path/to/applicationinsights-agent-3.4.7.jar"/>
95+
<option value="-javaagent:path/to/applicationinsights-agent-3.4.8.jar"/>
9696
<option value="-XX:MetaspaceSize=96m"/>
9797
<option value="-XX:MaxMetaspaceSize=256m"/>
9898
</jvm-options>
@@ -131,19 +131,19 @@ Add these lines to `start.ini`:
131131

132132
```
133133
--exec
134-
-javaagent:path/to/applicationinsights-agent-3.4.7.jar
134+
-javaagent:path/to/applicationinsights-agent-3.4.8.jar
135135
```
136136

137137
## Payara 5
138138

139-
Add `-javaagent:path/to/applicationinsights-agent-3.4.7.jar` to the existing `jvm-options` in `glassfish/domains/domain1/config/domain.xml`:
139+
Add `-javaagent:path/to/applicationinsights-agent-3.4.8.jar` to the existing `jvm-options` in `glassfish/domains/domain1/config/domain.xml`:
140140

141141
```xml
142142
...
143143
<java-config ...>
144144
<!--Edit the JVM options here-->
145145
<jvm-options>
146-
-javaagent:path/to/applicationinsights-agent-3.4.7.jar>
146+
-javaagent:path/to/applicationinsights-agent-3.4.8.jar>
147147
</jvm-options>
148148
...
149149
</java-config>
@@ -162,7 +162,7 @@ Add `-javaagent:path/to/applicationinsights-agent-3.4.7.jar` to the existing `jv
162162
1. In `Generic JVM arguments`, add the following JVM argument:
163163
164164
```
165-
-javaagent:path/to/applicationinsights-agent-3.4.7.jar
165+
-javaagent:path/to/applicationinsights-agent-3.4.8.jar
166166
```
167167
168168
1. Save and restart the application server.
@@ -172,7 +172,7 @@ Add `-javaagent:path/to/applicationinsights-agent-3.4.7.jar` to the existing `jv
172172
Create a new file `jvm.options` in the server directory (for example, `<openliberty>/usr/servers/defaultServer`), and add this line:
173173
174174
```
175-
-javaagent:path/to/applicationinsights-agent-3.4.7.jar
175+
-javaagent:path/to/applicationinsights-agent-3.4.8.jar
176176
```
177177
178178
## Others

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

Lines changed: 33 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Configuration options - Azure Monitor Application Insights for Java
33
description: This article shows you how to configure Azure Monitor Application Insights for Java.
44
ms.topic: conceptual
5-
ms.date: 12/14/2022
5+
ms.date: 01/18/2023
66
ms.devlang: java
77
ms.custom: devx-track-java
88
ms.reviewer: mmcc
@@ -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.7.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.8.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.7.jar` is located.
41+
If you specify a relative path, it will be resolved relative to the directory where `applicationinsights-agent-3.4.8.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.7.jar` is located.
64+
If you specify a relative path, it's resolved relative to the directory where `applicationinsights-agent-3.4.8.jar` is located.
6565

6666
```json
6767
{
@@ -323,6 +323,34 @@ Cloud role name overrides allow you to override the [default cloud role name](#c
323323
}
324324
```
325325

326+
## Connection string configured at runtime
327+
328+
Starting from version 3.4.8, if you need the ability to configure the connection string at runtime,
329+
add this property to your json configuration:
330+
331+
```json
332+
{
333+
"connectionStringConfiguredAtRuntime": true
334+
}
335+
```
336+
337+
and add `applicationinsights-core` to your application:
338+
339+
```xml
340+
<dependency>
341+
<groupId>com.microsoft.azure</groupId>
342+
<artifactId>applicationinsights-core</artifactId>
343+
<version>3.4.8</version>
344+
</dependency>
345+
```
346+
347+
and use the static `configure(String)` method in the class
348+
`com.microsoft.applicationinsights.connectionstring.ConnectionString`.
349+
350+
> [!NOTE]
351+
> Any telemetry that is captured prior to configuring the connection string will be dropped,
352+
> so it is best to configure it as early as possible in your application startup.
353+
326354
## Autocollect InProc dependencies (preview)
327355

328356
Starting from version 3.2.0, if you want to capture controller "InProc" dependencies, use the following configuration:
@@ -754,7 +782,7 @@ In the preceding configuration example:
754782

755783
* `level` can be one of `OFF`, `ERROR`, `WARN`, `INFO`, `DEBUG`, or `TRACE`.
756784
* `path` can be an absolute or relative path. Relative paths are resolved against the directory where
757-
`applicationinsights-agent-3.4.7.jar` is located.
785+
`applicationinsights-agent-3.4.8.jar` is located.
758786

759787
Starting from version 3.0.2, you can also set the self-diagnostics `level` by using the environment variable
760788
`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: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Upgrading from 2.x - Azure Monitor Application Insights Java
33
description: Upgrading from Azure Monitor Application Insights Java 2.x
44
ms.topic: conceptual
5-
ms.date: 12/14/2022
5+
ms.date: 01/18/2023
66
ms.devlang: java
77
ms.custom: devx-track-java
88
ms.reviewer: mmcc
@@ -32,7 +32,7 @@ auto-instrumentation which is provided by the 3.x Java agent.
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.7.jar
35+
-javaagent:path/to/applicationinsights-agent-3.4.8.jar
3636
```
3737

3838
If you were using the Application Insights 2.x Java agent, just replace your existing `-javaagent:...` with the above.
Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
---
2+
title: Quickstart - Add volume indicator to your Web calling app
3+
titleSuffix: An Azure Communication Services quickstart
4+
description: In this quickstart, you'll learn how to check call volume within your Web app when using Azure Communication Services.
5+
author: sloanster
6+
7+
ms.author: micahvivion
8+
ms.date: 1/18/2023
9+
ms.topic: quickstart
10+
ms.service: azure-communication-services
11+
ms.subservice: calling
12+
ms.custom: mode-other
13+
---
14+
15+
# Accessing call volume level
16+
As a developer you can have control over checking microphone volume in JavaScript. This quickstart shows examples of how to accomplish this within the ACS WebJS.
17+
18+
## Prerequisites
19+
[!INCLUDE [Public Preview](../../includes/public-preview-include-document.md)]
20+
21+
>[!IMPORTANT]
22+
> The quick start examples here are available starting on the public preview version [1.9.1-beta.1](https://www.npmjs.com/package/@azure/communication-calling/v/1.9.1-beta.1) of the calling Web SDK. Make sure to use that SDK version or newer when trying this quickstart.
23+
24+
## Checking the audio stream volume
25+
As a developer it can be nice to have the ability to check and display to end users the current microphone volume. ACS calling API exposes this information using `getVolume`. The `getVolume` value is a number ranging from 0 to 100 (with 0 noting zero audio detected, 100 as the max level detectable). This value iss sampled every 200 ms to get near real time value of volume.
26+
27+
### Example usage
28+
Sample code to get volume of selected microphone. This example shows how to generate the volume level by accessing `getVolume`.
29+
30+
```javascript
31+
//Get the vaolume of the local audio source
32+
const volumeIndicator = await new SDK.LocalAudioStream(deviceManager.selectedMicrophone).getVolume();
33+
volumeIndicator.on('levelChanged', ()=>{
34+
console.log(`Volume is ${volumeIndicator.level}`)
35+
})
36+
37+
//Get the volume level of the remote incoming audio source
38+
const remoteAudioStream = call.remoteAudioStreams[0];
39+
const volumeIndicator = await remoteAudioStream.getVolume();
40+
volumeIndicator.on('levelChanged', ()=>{
41+
console.log(`Volume is ${volumeIndicator.level}`)
42+
})
43+
44+
```
45+

articles/load-balancer/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -232,6 +232,8 @@
232232
href: move-across-regions-internal-load-balancer-powershell.md
233233
- name: IPv6
234234
items:
235+
- name: Configure DHCPv6 for Linux VMs
236+
href: load-balancer-ipv6-for-linux.md
235237
- name: Public Load Balancer
236238
items:
237239
- name: Standard Public Load Balancer with IPv6 - PowerShell

0 commit comments

Comments
 (0)