-
Notifications
You must be signed in to change notification settings - Fork 159
[DOCS] Enhance troubleshooting high cpu page. Opster migration #909
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from 2 commits
Commits
Show all changes
14 commits
Select commit
Hold shift + click to select a range
1aed359
updated doc
thekofimensah a339bac
Merge branch 'main' into kofi-high-cpu-troubleshooting
shainaraskas 1cdee78
Update troubleshoot/elasticsearch/high-cpu-usage.md
thekofimensah 1a5a967
Update troubleshoot/elasticsearch/high-cpu-usage.md
thekofimensah caa5dc1
Update troubleshoot/elasticsearch/high-cpu-usage.md
thekofimensah 2890ffb
Update troubleshoot/elasticsearch/high-cpu-usage.md
thekofimensah 1270365
Update troubleshoot/elasticsearch/high-cpu-usage.md
thekofimensah 449bd66
Update troubleshoot/elasticsearch/high-cpu-usage.md
thekofimensah 2634e95
Update troubleshoot/elasticsearch/high-cpu-usage.md
thekofimensah 7002d08
Update troubleshoot/elasticsearch/high-cpu-usage.md
thekofimensah 89e4274
Update troubleshoot/elasticsearch/high-cpu-usage.md
thekofimensah 6a396b9
Incorporated suggestions on headinds and subsections and rewording an…
thekofimensah 8bc5cbe
Merge branch 'main' into kofi-high-cpu-troubleshooting
shainaraskas 043598a
Apply suggestions from code review
shainaraskas File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change | ||||
---|---|---|---|---|---|---|
|
@@ -17,8 +17,6 @@ mapped_pages: | |||||
|
||||||
If a thread pool is depleted, {{es}} will [reject requests](rejected-requests.md) related to the thread pool. For example, if the `search` thread pool is depleted, {{es}} will reject search requests until more threads are available. | ||||||
|
||||||
You might experience high CPU usage if a [data tier](../../manage-data/lifecycle/data-tiers.md), and therefore the nodes assigned to that tier, is experiencing more traffic than other tiers. This imbalance in resource utilization is also known as [hot spotting](hotspotting.md). | ||||||
|
||||||
::::{tip} | ||||||
If you're using {{ech}}, you can use AutoOps to monitor your cluster. AutoOps significantly simplifies cluster management with performance recommendations, resource utilization visibility, and real-time issue detection with resolution paths. For more information, refer to [](/deploy-manage/monitor/autoops.md). | ||||||
:::: | ||||||
|
@@ -77,17 +75,54 @@ This API returns a breakdown of any hot threads in plain text. High CPU usage fr | |||||
|
||||||
The following tips outline the most common causes of high CPU usage and their solutions. | ||||||
shainaraskas marked this conversation as resolved.
Show resolved
Hide resolved
|
||||||
|
||||||
**Scale your cluster** | ||||||
**Check JVM garbage collection** | ||||||
thekofimensah marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
|
||||||
High CPU usage is often caused by excessive JVM garbage collection (GC) activity. This excessive GC typically arises from configuration problems or inefficient queries causing increased heap memory usage. | ||||||
|
||||||
For optimal JVM performance, garbage collection should meet these criteria: | ||||||
|
||||||
1. Young GC completes quickly (ideally within 50 ms). | ||||||
thekofimensah marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
2. Young GC does not occur too frequently (approximately once every 10 seconds). | ||||||
3. Old GC completes quickly (ideally within 1 second). | ||||||
4. Old GC does not occur too frequently (once every 10 minutes or less frequently). | ||||||
|
||||||
Excessive JVM garbage collection usually indicates high heap memory usage. Common potential reasons for increased heap memory usage include: | ||||||
|
||||||
* Oversharding of indices | ||||||
* Very large aggregation queries | ||||||
* Excessively large bulk indexing requests | ||||||
* Inefficient or incorrect mapping definitions | ||||||
* Improper heap size configuration | ||||||
* Misconfiguration of JVM new generation ratio (-XX:NewRatio) | ||||||
thekofimensah marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
|
||||||
**Hot spotting** | ||||||
|
||||||
You might experience high CPU usage on specific data nodes or an entire [data tier](/manage-data/lifecycle/data-tiers.md) if traffic isn’t evenly distributed—a scenario known as [hot spotting](hotspotting.md). This commonly occurs when read or write applications don’t properly balance requests across nodes, or when indices receiving heavy write activity (like hot-tier indices) have their shards concentrated on just one or a few nodes. | ||||||
thekofimensah marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
|
||||||
For details on diagnosing and resolving these issues, see [hot spotting](hotspotting.md). | ||||||
thekofimensah marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||||||
|
||||||
**Oversharding** | ||||||
|
||||||
If your Elasticsearch cluster contains a large number of shards, you might be facing an oversharding issue. | ||||||
|
If your Elasticsearch cluster contains a large number of shards, you might be facing an oversharding issue. |
Outdated
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Suggested change
Oversharding occurs when there are too many shards, causing each shard to be smaller than optimal. While Elasticsearch doesn’t have a strict minimum shard size, an excessive number of small shards can negatively impact performance. Each shard consumes cluster resources since Elasticsearch must maintain metadata and manage shard states across all nodes. | |
Oversharding occurs when there are too many shards, causing each shard to be smaller than optimal. While {{es}} doesn’t have a strict minimum shard size, an excessive number of small shards can negatively impact performance. Each shard consumes cluster resources, because {{es}} must maintain metadata and manage shard states across all nodes. |
thekofimensah marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
thekofimensah marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
thekofimensah marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
thekofimensah marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
thekofimensah marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
thekofimensah marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
thekofimensah marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
thekofimensah marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
thekofimensah marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
thekofimensah marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.