Skip to content

Comments

Add troubleshooting entry for killed processes in MTX#2309

Merged
swaldmann merged 7 commits intomainfrom
troubleshooting-mtx
Jan 9, 2026
Merged

Add troubleshooting entry for killed processes in MTX#2309
swaldmann merged 7 commits intomainfrom
troubleshooting-mtx

Conversation

@swaldmann
Copy link
Contributor

@swaldmann swaldmann commented Jan 9, 2026

To have a better guidance for projects running into resource constraints during tenant upgrades.

@swaldmann swaldmann requested review from ecklie and nkaputnik January 9, 2026 12:20
@swaldmann swaldmann marked this pull request as ready for review January 9, 2026 12:20
Copy link
Contributor

@ecklie ecklie left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍

@swaldmann
Copy link
Contributor Author

Merging this in so we can link to it for the Nexus colleagues. @renejeglinsky if there are further comments from your side just review them here and I'll create a follow-up PR.

@swaldmann swaldmann merged commit 0d2b34c into main Jan 9, 2026
8 checks passed
@swaldmann swaldmann deleted the troubleshooting-mtx branch January 9, 2026 12:49
In this case, the process was killed by a `SIGKILL` signal, typically because it exceeded its resource limits, for example memory or CPU, causing the container platform to terminate it.

::: tip Distinguish extensibility and non-extensibility scenarios
While out-of-memory issues are more common, with **extensibility enabled** you’re more likely to run into CPU bottlenecks due to expensive compilations that need to be performed at (MTX) runtime.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
While out-of-memory issues are more common, with **extensibility enabled** youre more likely to run into CPU bottlenecks due to expensive compilations that need to be performed at (MTX) runtime.
While out-of-memory issues are more common, with **extensibility enabled** you're more likely to run into CPU bottlenecks due to expensive compilations that need to be performed at (MTX) runtime.

While out-of-memory issues are more common, with **extensibility enabled** you’re more likely to run into CPU bottlenecks due to expensive compilations that need to be performed at (MTX) runtime.
:::

MTX uses **four parallel workers** by default to perform tenant upgrades. If your project exceeds a certain complexity threshold, you might run into these resource bottlenecks. We advise you to **follow this algorithm** to mitigate resource overload:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
MTX uses **four parallel workers** by default to perform tenant upgrades. If your project exceeds a certain complexity threshold, you might run into these resource bottlenecks. We advise you to **follow this algorithm** to mitigate resource overload:
By default, MTX uses **four parallel workers** to perform tenant upgrades. If your project exceeds a certain complexity threshold, you might run into these resource bottlenecks. We advise you to **follow this algorithm** to mitigate resource overload:

```
> This won't affect application runtime performance.

4. **Increase the number of MTX sidecars (scale out)**: To compensate for eventual performance losses from **3.**, distribute the work across multiple sidecars.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe it's more future-proof if we describe what 3. refers too :)

Suggested change
4. **Increase the number of MTX sidecars (scale out)**: To compensate for eventual performance losses from **3.**, distribute the work across multiple sidecars.
4. **Increase the number of MTX sidecars (scale out)**: If you decided to decrease workers in async operations, you can compensate eventual performance losses by distributing the work across multiple sidecars.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants