Skip to content

Commit 8a8aedc

Browse files
committed
updated links
1 parent 1074153 commit 8a8aedc

File tree

10 files changed

+24
-28
lines changed

10 files changed

+24
-28
lines changed

articles/spring-apps/.openpublishing.redirection.spring-apps.json

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -212,7 +212,12 @@
212212
},
213213
{
214214
"source_path": "concepts-for-java-memory-management.md",
215-
"redirect_url": "/azure/spring-apps/enterprise/concepts-for-java-memory-management",
215+
"redirect_url": "/azure/spring-apps/basic-standard/concepts-for-java-memory-management",
216+
"redirect_document_id": false
217+
},
218+
{
219+
"source_path": "enterprise/concepts-for-java-memory-management.md",
220+
"redirect_url": "/azure/spring-apps/basic-standard/concepts-for-java-memory-management",
216221
"redirect_document_id": true
217222
},
218223
{

articles/spring-apps/basic-standard/concepts-for-java-memory-management.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: KarlErickson
66
ms.author: kaiqianyang
77
ms.service: spring-apps
88
ms.topic: conceptual
9-
ms.date: 06/27/2024
9+
ms.date: 07/30/2024
1010
ms.custom: devx-track-java, devx-track-extended-java
1111
---
1212

@@ -27,7 +27,7 @@ A Java application's memory has several parts, and there are different ways to d
2727

2828
Heap memory stores all class instances and arrays. Each Java virtual machine (JVM) has only one heap area, which is shared among threads.
2929

30-
Spring Boot Actuator can observe the value of heap memory. Spring Boot Actuator takes the heap value as part of `jvm.memory.used/committed/max`. For more information, see the [jvm.memory.used/committed/max](tools-to-troubleshoot-memory-issues.md#jvmmemoryusedcommittedmax) section in [Tools to troubleshoot memory issues](tools-to-troubleshoot-memory-issues.md).
30+
Spring Boot Actuator can observe the value of heap memory. Spring Boot Actuator takes the heap value as part of `jvm.memory.used/committed/max`. For more information, see the [jvm.memory.used/committed/max](../enterprise/tools-to-troubleshoot-memory-issues.md#jvmmemoryusedcommittedmax) section in [Tools to troubleshoot memory issues](../enterprise/tools-to-troubleshoot-memory-issues.md).
3131

3232
Heap memory is divided into *young generation* and *old generation*. These terms are described in the following list, along with related terms.
3333

@@ -72,7 +72,7 @@ Full GC or major GC does garbage collection in the entire heap. Full GC can also
7272

7373
The maximum heap size influences the frequency of minor GC and full GC. The maximum metaspace and maximum direct memory size influence full GC.
7474

75-
When you set the maximum heap size to a lower value, garbage collections occur more frequently, which slow the app a little, but better limits the memory usage. When you set the maximum heap size to a higher value, garbage collections occur less frequently, which may create more out-of-memory (OOM) risk. For more information, see the [Types of out-of-memory issues](how-to-fix-app-restart-issues-caused-by-out-of-memory.md#types-of-out-of-memory-issues) section of [App restart issues caused by out-of-memory issues](how-to-fix-app-restart-issues-caused-by-out-of-memory.md).
75+
When you set the maximum heap size to a lower value, garbage collections occur more frequently, which slow the app a little, but better limits the memory usage. When you set the maximum heap size to a higher value, garbage collections occur less frequently, which may create more out-of-memory (OOM) risk. For more information, see the [Types of out-of-memory issues](../enterprise/how-to-fix-app-restart-issues-caused-by-out-of-memory.md#types-of-out-of-memory-issues) section of [App restart issues caused by out-of-memory issues](../enterprise/how-to-fix-app-restart-issues-caused-by-out-of-memory.md).
7676

7777
Metaspace and direct memory can be collected only by full GC. When metaspace or direct memory is full, full GC will occur.
7878

@@ -86,7 +86,7 @@ Applications in Azure Spring Apps run in container environments. For more inform
8686

8787
### Important JVM options
8888

89-
You can configure the maximum size of each part of memory by using JVM options. You can set JVM options by using Azure CLI commands or through the Azure portal. For more information, see the [Modify configurations to fix problems](tools-to-troubleshoot-memory-issues.md#modify-configurations-to-fix-problems) section of [Tools to troubleshoot memory issues](tools-to-troubleshoot-memory-issues.md).
89+
You can configure the maximum size of each part of memory by using JVM options. You can set JVM options by using Azure CLI commands or through the Azure portal. For more information, see the [Modify configurations to fix problems](../enterprise/tools-to-troubleshoot-memory-issues.md#modify-configurations-to-fix-problems) section of [Tools to troubleshoot memory issues](../enterprise/tools-to-troubleshoot-memory-issues.md).
9090

9191
The following list describes the JVM options:
9292

@@ -156,9 +156,9 @@ Overall, when configuring maximum memory sizes, you should consider the usage of
156156

157157
## Java OOM
158158

159-
OOM means the application is out of memory. There are two different concepts: container OOM and JVM OOM. For more information, see [App restart issues caused by out-of-memory issues](how-to-fix-app-restart-issues-caused-by-out-of-memory.md).
159+
OOM means the application is out of memory. There are two different concepts: container OOM and JVM OOM. For more information, see [App restart issues caused by out-of-memory issues](../enterprise/how-to-fix-app-restart-issues-caused-by-out-of-memory.md).
160160

161161
## See also
162162

163-
- [App restart issues caused by out-of-memory issues](how-to-fix-app-restart-issues-caused-by-out-of-memory.md)
164-
- [Tools to troubleshoot memory issues](tools-to-troubleshoot-memory-issues.md)
163+
- [App restart issues caused by out-of-memory issues](../enterprise/how-to-fix-app-restart-issues-caused-by-out-of-memory.md)
164+
- [Tools to troubleshoot memory issues](../enterprise/tools-to-troubleshoot-memory-issues.md)

articles/spring-apps/basic-standard/toc.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,7 @@ items:
6969
- name: Memory
7070
items:
7171
- name: Java memory management
72-
href: ../enterprise/concepts-for-java-memory-management.md?toc=/azure/spring-apps/basic-standard/toc.json&bc=/azure/spring-apps/basic-standard/breadcrumb/toc.json
72+
href: concepts-for-java-memory-management.md
7373
- name: Tools to troubleshoot memory issues
7474
href: ../enterprise/tools-to-troubleshoot-memory-issues.md?toc=/azure/spring-apps/basic-standard/toc.json&bc=/azure/spring-apps/basic-standard/breadcrumb/toc.json
7575
- name: Fix app restart issues caused by OOM

articles/spring-apps/consumption-dedicated/index.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -95,7 +95,7 @@ landingContent:
9595
- linkListType: concept
9696
links:
9797
- text: Java memory management
98-
url: ../enterprise/concepts-for-java-memory-management.md?toc=/azure/spring-apps/consumption-dedicated/toc.json&bc=/azure/spring-apps/consumption-dedicated/breadcrumb/toc.json
98+
url: ../basic-standard/concepts-for-java-memory-management.md?toc=/azure/spring-apps/consumption-dedicated/toc.json&bc=/azure/spring-apps/consumption-dedicated/breadcrumb/toc.json
9999
- linkListType: quickstart
100100
links:
101101
- text: Analyze logs and metrics

articles/spring-apps/consumption-dedicated/toc.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ items:
5353
- name: Memory
5454
items:
5555
- name: Java memory management
56-
href: ../enterprise/concepts-for-java-memory-management.md?toc=/azure/spring-apps/consumption-dedicated/toc.json&bc=/azure/spring-apps/consumption-dedicated/breadcrumb/toc.json
56+
href: ../basic-standard/concepts-for-java-memory-management.md?toc=/azure/spring-apps/consumption-dedicated/toc.json&bc=/azure/spring-apps/consumption-dedicated/breadcrumb/toc.json
5757
- name: Tools to troubleshoot memory issues
5858
href: ../enterprise/tools-to-troubleshoot-memory-issues.md?toc=/azure/spring-apps/consumption-dedicated/toc.json&bc=/azure/spring-apps/consumption-dedicated/breadcrumb/toc.json
5959
- name: Fix app restart issues caused by OOM

articles/spring-apps/enterprise/how-to-fix-app-restart-issues-caused-by-out-of-memory.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ The **Resource health** page on the Azure portal shows app restart events due to
4343

4444
The metrics *App memory Usage*, `jvm.memory.used`, and `jvm.memory.committed` provide a view of memory usage. For more information, see the [Metrics](tools-to-troubleshoot-memory-issues.md#metrics) section of [Tools to troubleshoot memory issues](tools-to-troubleshoot-memory-issues.md). Configure the maximum memory sizes in JVM options to ensure that memory is under the limit.
4545

46-
The sum of the maximum memory sizes of all the parts in the [Java memory model](concepts-for-java-memory-management.md#java-memory-model) should be less than the real available app memory. To set your maximum memory sizes, see the typical memory layout described in the [Memory usage layout](concepts-for-java-memory-management.md#memory-usage-layout) section of [Java memory management](concepts-for-java-memory-management.md).
46+
The sum of the maximum memory sizes of all the parts in the [Java memory model](../basic-standard/concepts-for-java-memory-management.md#java-memory-model) should be less than the real available app memory. To set your maximum memory sizes, see the typical memory layout described in the [Memory usage layout](../basic-standard/concepts-for-java-memory-management.md#memory-usage-layout) section of [Java memory management](../basic-standard/concepts-for-java-memory-management.md).
4747

4848
Find a balance when you set the maximum memory size. When you set the maximum memory size too high, there's a risk of container OOM. When you set the maximum memory size too low, there's a risk of JVM OOM, and garbage collection will be of and will slow down the app.
4949

@@ -70,5 +70,5 @@ Metaspace memory is usually stable.
7070

7171
## See also
7272

73-
- [Java memory management](concepts-for-java-memory-management.md)
73+
- [Java memory management](../basic-standard/concepts-for-java-memory-management.md)
7474
- [Tools to troubleshoot memory issues](tools-to-troubleshoot-memory-issues.md)

articles/spring-apps/enterprise/index.yml

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -112,10 +112,6 @@ landingContent:
112112
url: structured-app-log.md
113113
- text: Analyze logs and metrics
114114
url: diagnostic-services.md
115-
- linkListType: concept
116-
links:
117-
- text: Java memory management
118-
url: concepts-for-java-memory-management.md
119115

120116
# Card (optional)
121117
- title: Secure apps

articles/spring-apps/enterprise/toc.yml

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -82,8 +82,6 @@ items:
8282
href: concept-app-status.md
8383
- name: Memory
8484
items:
85-
- name: Java memory management
86-
href: concepts-for-java-memory-management.md
8785
- name: Tools to troubleshoot memory issues
8886
href: tools-to-troubleshoot-memory-issues.md
8987
- name: Fix app restart issues caused by OOM

articles/spring-apps/enterprise/tools-to-troubleshoot-memory-issues.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ App memory usage is a percentage equal to the app memory used divided by the app
5757

5858
For JVM memory, there are three metrics: `jvm.memory.used`, `jvm.memory.committed`, and `jvm.memory.max`, which are described in the following list.
5959

60-
"JVM memory" isn't a clearly defined concept. Here, `jvm.memory` is the sum of [heap memory](concepts-for-java-memory-management.md#heap-memory) and former permGen part of [non-heap memory](concepts-for-java-memory-management.md#non-heap-memory). JVM memory doesn't include direct memory or other memory like the thread stack. Spring Boot Actuator gathers these three metrics and determines the scope of `jvm.memory`.
60+
"JVM memory" isn't a clearly defined concept. Here, `jvm.memory` is the sum of [heap memory](../basic-standard/concepts-for-java-memory-management.md#heap-memory) and former permGen part of [non-heap memory](../basic-standard/concepts-for-java-memory-management.md#non-heap-memory). JVM memory doesn't include direct memory or other memory like the thread stack. Spring Boot Actuator gathers these three metrics and determines the scope of `jvm.memory`.
6161

6262
- `jvm.memory.used` is the amount of used JVM memory, including used heap memory and used former permGen in non-heap memory.
6363

@@ -69,13 +69,13 @@ For JVM memory, there are three metrics: `jvm.memory.used`, `jvm.memory.committe
6969

7070
- `jvm.memory.max` is the maximum amount of JVM memory, not to be confused with the real available amount.
7171

72-
The value of `jvm.memory.max` can sometimes be confusing because it can be much higher than the available app memory. To clarify, `jvm.memory.max` is the sum of all maximum sizes of heap memory and the former permGen part of [non-heap memory](concepts-for-java-memory-management.md#non-heap-memory), regardless of the real available memory. For example, if an app is set with 1 GB of memory in the Azure Spring Apps portal, then the default heap memory size is 0.5 GB. For more information, see the [Default maximum heap size](concepts-for-java-memory-management.md#default-maximum-heap-size) section of [Java memory management](concepts-for-java-memory-management.md).
72+
The value of `jvm.memory.max` can sometimes be confusing because it can be much higher than the available app memory. To clarify, `jvm.memory.max` is the sum of all maximum sizes of heap memory and the former permGen part of [non-heap memory](../basic-standard/concepts-for-java-memory-management.md#non-heap-memory), regardless of the real available memory. For example, if an app is set with 1 GB of memory in the Azure Spring Apps portal, then the default heap memory size is 0.5 GB. For more information, see the [Default maximum heap size](../basic-standard/concepts-for-java-memory-management.md#default-maximum-heap-size) section of [Java memory management](../basic-standard/concepts-for-java-memory-management.md).
7373

7474
If the default *compressed class space* size is 1 GB, then the value of `jvm.memory.max` is larger than 1.5 GB regardless of whether the app memory size 1 GB. For more information, see [Java Platform, Standard Edition HotSpot Virtual Machine Garbage Collection Tuning Guide: Other Considerations](https://docs.oracle.com/javase/9/gctuning/other-considerations.htm) in the Oracle documentation.
7575

7676
#### jvm.gc.memory.allocated/promoted
7777

78-
These two metrics are for observing Java garbage collection (GC). For more information, see the [Java garbage collection](concepts-for-java-memory-management.md#java-garbage-collection) section of [Java memory management](concepts-for-java-memory-management.md). The maximum heap size influences the frequency of minor GC and full GC. The maximum metaspace and maximum direct memory size influence full GC. If you want to adjust the frequency of garbage collection, consider modifying the following maximum memory sizes.
78+
These two metrics are for observing Java garbage collection (GC). For more information, see the [Java garbage collection](../basic-standard/concepts-for-java-memory-management.md#java-garbage-collection) section of [Java memory management](../basic-standard/concepts-for-java-memory-management.md). The maximum heap size influences the frequency of minor GC and full GC. The maximum metaspace and maximum direct memory size influence full GC. If you want to adjust the frequency of garbage collection, consider modifying the following maximum memory sizes.
7979

8080
- `jvm.gc.memory.allocated` is the amount of increase in the size of the young generation memory pool after one GC and before the next. This value reflects minor GC.
8181

@@ -97,7 +97,7 @@ For more information, see [Capture heap dump and thread dump manually and use Ja
9797

9898
## Modify configurations to fix problems
9999

100-
Some issues you might identify include [container OOM](how-to-fix-app-restart-issues-caused-by-out-of-memory.md#fix-app-restart-issues-due-to-oom), heap memory that's too large, and abnormal garbage collection. If you identify any of these issues, you may need to configure the maximum memory size in the JVM options. For more information, see the [Important JVM options](concepts-for-java-memory-management.md#important-jvm-options) section of [Java memory management](concepts-for-java-memory-management.md#important-jvm-options).
100+
Some issues you might identify include [container OOM](how-to-fix-app-restart-issues-caused-by-out-of-memory.md#fix-app-restart-issues-due-to-oom), heap memory that's too large, and abnormal garbage collection. If you identify any of these issues, you may need to configure the maximum memory size in the JVM options. For more information, see the [Important JVM options](../basic-standard/concepts-for-java-memory-management.md#important-jvm-options) section of [Java memory management](../basic-standard/concepts-for-java-memory-management.md#important-jvm-options).
101101

102102
You can modify the JVM options by using the Azure portal or the Azure CLI.
103103

@@ -124,5 +124,5 @@ az spring app update \
124124

125125
## See also
126126

127-
- [Java memory management](concepts-for-java-memory-management.md)
127+
- [Java memory management](../basic-standard/concepts-for-java-memory-management.md)
128128
- [App restart issues caused by out-of-memory issues](how-to-fix-app-restart-issues-caused-by-out-of-memory.md)

articles/spring-apps/index.yml

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -135,9 +135,6 @@ conceptualContent:
135135
- text: Use custom DNS names
136136
url: enterprise/how-to-custom-domain.md
137137
itemType: how-to-guide
138-
- text: Java memory management
139-
url: enterprise/concepts-for-java-memory-management.md
140-
itemType: concept
141138
- text: Use structured application logs
142139
url: enterprise/structured-app-log.md
143140
itemType: how-to-guide
@@ -327,7 +324,7 @@ conceptualContent:
327324
- title: Manage and monitor apps
328325
links:
329326
- text: Java memory management
330-
url: enterprise/concepts-for-java-memory-management.md?toc=/azure/spring-apps/consumption-dedicated/toc.json&bc=/azure/spring-apps/consumption-dedicated/breadcrumb/toc.json
327+
url: basic-standard/concepts-for-java-memory-management.md?toc=/azure/spring-apps/consumption-dedicated/toc.json&bc=/azure/spring-apps/consumption-dedicated/breadcrumb/toc.json
331328
itemType: concept
332329
- text: Analyze logs and metrics
333330
url: consumption-dedicated/quickstart-analyze-logs-and-metrics-standard-consumption.md

0 commit comments

Comments
 (0)