Update retention results for 8.8. #7202

rodrigo-lourenco-lopes · 2025-10-29T13:11:37Z

Description

Retention results observed here https://camunda.slack.com/archives/C09JCQU1WF4/p1761573328549529.
The values obtained for the base size through the experiments were between 220k and 260k of historical process instances when the disk was at 70% (when the disk is this full, we do start to see some exporting performance degradation). In the same way we did with the peak rate of PIs, these numbers are also a bit conservative due to the vast range of sizes that Process models can take.

This way, the proposed retention values were multiples of the 200k base, namelly:

1x	2x	3x	4x
200k	400k	600k	800k

closes camunda/camunda#38501
closes #7233

When should this change go live?

This is a bug fix, security concern, or something that needs urgent release support. (add bug or support label)
This is already available but undocumented and should be released within a week. (add available & undocumented label)
This is on a specific schedule and the assignee will coordinate a release with the Documentation team. (create draft PR and/or add hold label)
This is part of a scheduled alpha or minor. (add alpha or minor label)
There is no urgency with this change (add low prio label)

PR Checklist

The commit history of this PR is cleaned up, using {type}(scope): {description} commit message(s)

My changes are for an upcoming minor release and are in the /docs directory (version 8.8).
My changes are for an already released minor and are in a /versioned_docs directory.

I added a DRI, team, or delegate as a reviewer for technical accuracy and grammar/style:
- Engineering team review
- Technical writer review via @camunda/tech-writers unless working with an embedded writer.

versioned_docs/version-8.7/components/best-practices/architecture/sizing-your-environment.md

github-actions · 2025-11-03T09:21:22Z

👋 🤖 ✅ Looks like the changes were ported across versions, nice job! 🎉

You can read more about the versioning within our docs in our documentation guidelines.

rodrigo-lourenco-lopes · 2025-11-10T08:51:51Z

@npepinpe or @entangled90 can I get a rereview here?

entangled90

Please have a look at my comments, minor stuff

versioned_docs/version-8.8/components/best-practices/architecture/sizing-your-environment.md

entangled90 · 2025-11-10T08:54:36Z

docs/components/best-practices/architecture/sizing-your-environment.md

 | Approximate resources provisioned **\*\*\*\***                                      | 11 vCPU, 22 GB memory, 192 GB disk. | 22 vCPU, 44 GB memory, 384 GB disk. | 33 vCPU, 66 GB mem, 576 GB disk. | 44 vCPU, 88 GB mem, 768 GB disk. |

-The numbers in the table were measured using Camunda 8 (version 8.6), [the benchmark project](https://github.com/camunda-community-hub/camunda-8-benchmark) running on its own Kubernetes Cluster, and using a [realistic process](https://github.com/camunda/camunda/blob/main/zeebe/benchmarks/project/src/main/resources/bpmn/realistic/bankCustomerComplaintDisputeHandling.bpmn) containing a mix of BPMN symbols such as tasks, events and call activities including subprocesses. To calculate day-based metrics, an equal distribution over 24 hours is assumed.
+The numbers in the table were measured using Camunda 8 (version 8.6), [the benchmark project](https://github.com/camunda-community-hub/camunda-8-benchmark) running on its own Kubernetes Cluster, and using a [realistic process](https://github.com/camunda/camunda/blob/main/load-tests/load-tester/src/main/resources/bpmn/realistic/bankCustomerComplaintDisputeHandling.bpmn) containing a mix of BPMN symbols such as tasks, events and call activities including subprocesses. To calculate day-based metrics, an equal distribution over 24 hours is assumed.


❓ Is this version (version 8.6) correct? Just double checking

We will have to re-run these again for 8.9, or just show the results from 8.8 🤔

I changed the values in next to be the same as 8.8, which makes more sense than showing the old values

github-actions · 2025-11-14T13:23:15Z

docs/components/best-practices/architecture/sizing-your-environment.md


 | Cluster size                                                                        |                                  1x |                                  2x |                               3x |                               4x |
-| :---------------------------------------------------------------------------------- | ----------------------------------: | ----------------------------------: | -------------------------------: | -------------------------------: |
+| :---------------------------------------------------------------------------------- |------------------------------------:|------------------------------------:|---------------------------------:|---------------------------------:|


[prettier] _{reported by reviewdog 🐶}

Suggested change

| :---------------------------------------------------------------------------------- |------------------------------------:|------------------------------------:|---------------------------------:|---------------------------------:|

| :---------------------------------------------------------------------------------- | ----------------------------------: | ----------------------------------: | -------------------------------: | -------------------------------: |

❓ Was this change applied by some formatter?

github-actions · 2025-11-14T13:23:15Z

docs/components/best-practices/architecture/sizing-your-environment.md

 | Approximate resources provisioned **\*\*\*\***                                      | 11 vCPU, 22 GB memory, 192 GB disk. | 22 vCPU, 44 GB memory, 384 GB disk. | 33 vCPU, 66 GB mem, 576 GB disk. | 44 vCPU, 88 GB mem, 768 GB disk. |

-The numbers in the table were measured using Camunda 8 (version 8.6), [the benchmark project](https://github.com/camunda-community-hub/camunda-8-benchmark) running on its own Kubernetes Cluster, and using a [realistic process](https://github.com/camunda/camunda/blob/main/zeebe/benchmarks/project/src/main/resources/bpmn/realistic/bankCustomerComplaintDisputeHandling.bpmn) containing a mix of BPMN symbols such as tasks, events and call activities including subprocesses. To calculate day-based metrics, an equal distribution over 24 hours is assumed.
+The numbers in the table were measured using Camunda 8 (version 8.8), [the 


[prettier] _{reported by reviewdog 🐶}

Suggested change

The numbers in the table were measured using Camunda 8 (version 8.8), [the

The numbers in the table were measured using Camunda 8 (version 8.8), [the

github-actions · 2025-11-14T13:23:15Z

versioned_docs/version-8.8/components/best-practices/architecture/sizing-your-environment.md


 | Cluster size                                                                        |                                  1x |                                  2x |                               3x |                               4x |
-| :---------------------------------------------------------------------------------- | ----------------------------------: | ----------------------------------: | -------------------------------: | -------------------------------: |
+| :---------------------------------------------------------------------------------- |------------------------------------:|------------------------------------:|---------------------------------:|---------------------------------:|


[prettier] _{reported by reviewdog 🐶}

Suggested change

| :---------------------------------------------------------------------------------- |------------------------------------:|------------------------------------:|---------------------------------:|---------------------------------:|

| :---------------------------------------------------------------------------------- | ----------------------------------: | ----------------------------------: | -------------------------------: | -------------------------------: |

github-actions · 2025-11-14T13:23:15Z

versioned_docs/version-8.8/components/best-practices/architecture/sizing-your-environment.md

 | Approximate resources provisioned **\*\*\*\***                                      | 11 vCPU, 22 GB memory, 192 GB disk. | 22 vCPU, 44 GB memory, 384 GB disk. | 33 vCPU, 66 GB mem, 576 GB disk. | 44 vCPU, 88 GB mem, 768 GB disk. |

-The numbers in the table were measured using Camunda 8 (version 8.6), [the benchmark project](https://github.com/camunda-community-hub/camunda-8-benchmark) running on its own Kubernetes Cluster, and using a [realistic process](https://github.com/camunda/camunda/blob/main/zeebe/benchmarks/project/src/main/resources/bpmn/realistic/bankCustomerComplaintDisputeHandling.bpmn) containing a mix of BPMN symbols such as tasks, events and call activities including subprocesses. To calculate day-based metrics, an equal distribution over 24 hours is assumed.
+The numbers in the table were measured using Camunda 8 (version 8.8), [the 


[prettier] _{reported by reviewdog 🐶}

Suggested change

The numbers in the table were measured using Camunda 8 (version 8.8), [the

The numbers in the table were measured using Camunda 8 (version 8.8), [the

entangled90 · 2025-11-18T09:07:04Z

docs/components/best-practices/architecture/sizing-your-environment.md


 | Cluster size                                                                        |                                  1x |                                  2x |                               3x |                               4x |
-| :---------------------------------------------------------------------------------- | ----------------------------------: | ----------------------------------: | -------------------------------: | -------------------------------: |
+| :---------------------------------------------------------------------------------- |------------------------------------:|------------------------------------:|---------------------------------:|---------------------------------:|


❓ Was this change applied by some formatter?

entangled90 · 2025-11-18T09:08:24Z

versioned_docs/version-8.7/components/best-practices/architecture/sizing-your-environment.md

 | Approximate resources provisioned **\*\*\*\***                                      | 11 vCPU, 22 GB memory, 192 GB disk. | 22 vCPU, 44 GB memory, 384 GB disk. | 33 vCPU, 66 GB mem, 576 GB disk. | 44 vCPU, 88 GB mem, 768 GB disk. |

-The numbers in the table were measured using Camunda 8 (version 8.6), [the benchmark project](https://github.com/camunda-community-hub/camunda-8-benchmark) running on its own Kubernetes Cluster, and using a [realistic process](https://github.com/camunda/camunda/blob/main/zeebe/benchmarks/project/src/main/resources/bpmn/realistic/bankCustomerComplaintDisputeHandling.bpmn) containing a mix of BPMN symbols such as tasks, events and call activities including subprocesses. To calculate day-based metrics, an equal distribution over 24 hours is assumed.
+The numbers in the table were measured using Camunda 8 (version 8.6), [the benchmark project](https://github.com/camunda-community-hub/camunda-8-benchmark) running on its own Kubernetes Cluster, and using a [realistic process](https://github.com/camunda/camunda/blob/main/load-tests/load-tester/src/main/resources/bpmn/realistic/bankCustomerComplaintDisputeHandling.bpmn) containing a mix of BPMN symbols such as tasks, events and call activities including subprocesses. To calculate day-based metrics, an equal distribution over 24 hours is assumed.


❓ is it correct that we still mention camunda 8.6 in folder 8.7?

feat: update retention results for 8.8.

207a292

github-actions bot assigned rodrigo-lourenco-lopes Oct 29, 2025

rodrigo-lourenco-lopes marked this pull request as draft October 29, 2025 13:15

rodrigo-lourenco-lopes mentioned this pull request Oct 29, 2025

Update SaaS cluster sizing for 8.8 camunda/camunda#38501

Open

3 tasks

rodrigo-lourenco-lopes requested a review from npepinpe October 29, 2025 15:06

rodrigo-lourenco-lopes marked this pull request as ready for review October 29, 2025 15:06

rodrigo-lourenco-lopes requested a review from a team October 29, 2025 15:07

camunda-docs-pr-automation bot added this to Documentation Team Oct 29, 2025

camunda-docs-pr-automation bot moved this to 👀 In Review in Documentation Team Oct 29, 2025

rodrigo-lourenco-lopes requested a review from entangled90 October 30, 2025 08:55

entangled90 reviewed Oct 30, 2025

View reviewed changes

versioned_docs/version-8.7/components/best-practices/architecture/sizing-your-environment.md Outdated Show resolved Hide resolved

fix: fix move metrics to correct version.

d1db33a

rodrigo-lourenco-lopes requested a review from entangled90 November 3, 2025 09:21

fix: fix broken link.

d6dce5b

entangled90 requested changes Nov 10, 2025

View reviewed changes

rodrigo-lourenco-lopes added 2 commits November 14, 2025 14:16

fix: fix typo.

186b7cf

fix: make next/docs show same results as 8.8.

6536b4e

rodrigo-lourenco-lopes requested a review from entangled90 November 14, 2025 13:22

github-actions bot reviewed Nov 14, 2025

View reviewed changes

entangled90 reviewed Nov 18, 2025

View reviewed changes

	\| :---------------------------------------------------------------------------------- \|------------------------------------:\|------------------------------------:\|---------------------------------:\|---------------------------------:\|
	\| :---------------------------------------------------------------------------------- \| ----------------------------------: \| ----------------------------------: \| -------------------------------: \| -------------------------------: \|

	The numbers in the table were measured using Camunda 8 (version 8.8), [the
	The numbers in the table were measured using Camunda 8 (version 8.8), [the

Update retention results for 8.8. #7202

Are you sure you want to change the base?

Update retention results for 8.8. #7202

Conversation

rodrigo-lourenco-lopes commented Oct 29, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

When should this change go live?

PR Checklist

Uh oh!

Uh oh!

github-actions bot commented Nov 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

rodrigo-lourenco-lopes commented Nov 10, 2025

Uh oh!

entangled90 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

entangled90 Nov 10, 2025

Choose a reason for hiding this comment

Uh oh!

rodrigo-lourenco-lopes Nov 14, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

rodrigo-lourenco-lopes Nov 14, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 14, 2025

Choose a reason for hiding this comment

Uh oh!

entangled90 Nov 18, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 14, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 14, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot Nov 14, 2025

Choose a reason for hiding this comment

Uh oh!

entangled90 Nov 18, 2025

Choose a reason for hiding this comment

Uh oh!

entangled90 Nov 18, 2025

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

rodrigo-lourenco-lopes commented Oct 29, 2025 •

edited

Loading

github-actions bot commented Nov 3, 2025 •

edited

Loading

rodrigo-lourenco-lopes Nov 14, 2025 •

edited

Loading