Skip to content

Commit 555ea4f

Browse files
committed
Sending final updates to merge
1 parent 74d1d08 commit 555ea4f

File tree

1 file changed

+17
-29
lines changed

1 file changed

+17
-29
lines changed

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

Lines changed: 17 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -27,11 +27,7 @@ This data is gathered on demand when trigger conditions are met. The available t
2727
When a threshold is reached, a profile of the configured type and duration is gathered and uploaded. This profile is then visible within the performance blade of the associated Application Insights Portal UI.
2828

2929
> [!WARNING]
30-
> The JFR profiler by default executes the "profile-without-env-data" profile. A JFR file is a series of
31-
> events emitted by the JVM. The "profile-without-env-data" configuration, is similar to the "profile"
32-
> configuration that ships with the JVM, however has had some events disabled that have the potential to
33-
> contain sensitive deployment information such as environment variables, arguments provided to the JVM
34-
> and processes running on the system.
30+
> The JFR profiler by default executes the "profile-without-env-data" profile. A JFR file is a series of events emitted by the JVM. The "profile-without-env-data" configuration, is similar to the "profile" configuration that ships with the JVM, however has had some events disabled that have the potential to contain sensitive deployment information such as environment variables, arguments provided to the JVM and processes running on the system.
3531
3632
The flags that have been disabled are:
3733

@@ -68,11 +64,15 @@ Within the profiler user interface (see [profiler settings](../profiler/profiler
6864

6965
#### CPU
7066

71-
For CPU, the threshold is a percentage of the usage of all available cores on the system, for instance, if your machine has saturated one core of an eight core machine the CPU percentage would be considered 12.5%.
67+
CPU threshold is a percentage of the usage of all available cores on the system.
68+
69+
As an example, if one core of an eight core machine were saturated the CPU percentage would be considered 12.5%.
7270

7371
#### Memory
7472

75-
For memory, the percentage is the current Tenured memory region (OldGen) occupancy against the maximum possible size of the region, the occupancy is evaluated after a tenured collection has been performed. The maximum size of the tenured region is the size it would be if the JVMs' heap grew to its maximum size.
73+
Memory percentage is the current Tenured memory region (OldGen) occupancy against the maximum possible size of the region.
74+
75+
Occupancy is evaluated after a tenured collection has been performed. The maximum size of the tenured region is the size it would be if the JVMs' heap grew to its maximum size.
7676

7777
For instance, take the following scenario:
7878

@@ -83,14 +83,12 @@ For instance, take the following scenario:
8383

8484
In this scenario, a profile will occur in the following circumstances:
8585

86-
- A full garbage collection is executed.
87-
- After the collection is finished, the Tenured regions occupancy is above 691 mb.
86+
- Full garbage collection is executed
87+
- The Tenured regions occupancy is above 691 mb after collection
8888

8989
### Installation
9090

91-
The following steps will guide you through enabling the profiling component on the agent and
92-
configuring resource limits that will trigger a profile if breached.
93-
91+
The following steps will guide you through enabling the profiling component on the agent and configuring resource limits that will trigger a profile if breached.
9492

9593
1. Configure the resource thresholds that will cause a profile to be collected:
9694

@@ -121,23 +119,16 @@ configuring resource limits that will trigger a profile if breached.
121119
> [!WARNING]
122120
> The Java profiler does not support the "Sampling" trigger. Configuring this will have no effect.
123121
124-
After these steps have been completed, the agent will monitor the resource usage of your process and
125-
trigger a profile when the threshold is exceeded. When a profile has been triggered and completed, it will be
126-
viewable from the
127-
Application Insights instance within the Performance -> Profiler section. From that screen the
128-
profile can be downloaded, once download the JFR recording file can be opened and analyzed within a
129-
tool of your choosing, for example JDK Mission Control (JMC).
122+
After these steps have been completed, the agent will monitor the resource usage of your process and trigger a profile when the threshold is exceeded. When a profile has been triggered and completed, it will be viewable from the
123+
Application Insights instance within the Performance -> Profiler section. From that screen the profile can be downloaded, once download the JFR recording file can be opened and analyzed within a tool of your choosing, for example JDK Mission Control (JMC).
130124

131125
:::image type="content" source="./media/java-standalone-profiler/configure-blade-inline.png" alt-text="Screenshot of profiler page features and settings." lightbox="media/java-standalone-profiler/configure-blade-inline.png":::
132126

133127
### Configuration
134128

135-
Configuration of the profiler triggering settings, such as thresholds and profiling periods, are set
136-
within the ApplicationInsights UI under the Performance, Profiler, Triggers UI as
137-
described in [Installation](#installation).
129+
Configuration of the profiler triggering settings, such as thresholds and profiling periods, are set within the ApplicationInsights UI under the Performance, Profiler, Triggers UI as described in [Installation](#installation).
138130

139-
Additionally, many parameters can be configured using environment variables and the
140-
`applicationinsights.json` configuration file.
131+
Additionally, many parameters can be configured using environment variables and the `applicationinsights.json` configuration file.
141132

142133
#### Configuring Profile Contents
143134

@@ -168,19 +159,16 @@ Example configuration:
168159

169160
```
170161

171-
`memoryTriggeredSettings` This configuration will be used if a memory profile is
172-
requested. This value can be one of:
162+
`memoryTriggeredSettings` This configuration will be used if a memory profile is requested. This value can be one of:
173163

174-
- `profile-without-env-data` (default value). A profile with certain sensitive events disabled, see
175-
Warning section above for details.
164+
- `profile-without-env-data` (default value). A profile with certain sensitive events disabled, see Warning section above for details.
176165
- `profile`. Uses the `profile.jfc` configuration that ships with JFR.
177166
- A path to a custom jfc configuration file on the file system, i.e `/tmp/myconfig.jfc`.
178167

179168
`cpuTriggeredSettings` This configuration will be used if a cpu profile is requested.
180169
This value can be one of:
181170

182-
- `profile-without-env-data` (default value). A profile with certain sensitive events disabled, see
183-
Warning section above for details.
171+
- `profile-without-env-data` (default value). A profile with certain sensitive events disabled, see Warning section above for details.
184172
- `profile`. Uses the `profile.jfc` jfc configuration that ships with JFR.
185173
- A path to a custom jfc configuration file on the file system, i.e `/tmp/myconfig.jfc`.
186174

0 commit comments

Comments
 (0)