Skip to content
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

Add docs to achieve 200K scale. #7812

Merged
merged 3 commits into from
Mar 20, 2025
Merged

Add docs to achieve 200K scale. #7812

merged 3 commits into from
Mar 20, 2025

Conversation

agnivade
Copy link
Member

No description provided.

Copy link

Newest code from mattermost has been published to preview environment for Git SHA b570ce6

@agnivade agnivade added 1: Dev Review Requires review by a core commiter 2: Editor Review Requires review by an editor labels Mar 19, 2025
Copy link
Member

@agarciamontoro agarciamontoro left a comment

Choose a reason for hiding this comment

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

Looks great! Some non-blocking comments below :)


.. note::
- Usage of CPU, RAM, and storage space can vary significantly based on user behavior. These hardware recommendations are based on traditional deployments and may grow or shrink depending on how active your users are.
- From Mattermost v10.4, Mattermost Enterprise customers can configure `Redis <https://redis.io/>`_ (Remote Dictionary Server) as an alternative cache backend. Using Redis can help ensure that Mattermost remains performant and efficient, even under heavy usage. See the :ref:`Redis cache backend <configure/environment-configuration-settings:redis cache backend>` configuration settings documentation for details.
Copy link
Member

Choose a reason for hiding this comment

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

Do we need the Remote Dictionary Server parenthesis?

Suggested change
- From Mattermost v10.4, Mattermost Enterprise customers can configure `Redis <https://redis.io/>`_ (Remote Dictionary Server) as an alternative cache backend. Using Redis can help ensure that Mattermost remains performant and efficient, even under heavy usage. See the :ref:`Redis cache backend <configure/environment-configuration-settings:redis cache backend>` configuration settings documentation for details.
- From Mattermost v10.4, Mattermost Enterprise customers can configure `Redis <https://redis.io/>`_ as an alternative cache backend. Using Redis can help ensure that Mattermost remains performant and efficient, even under heavy usage. See the :ref:`Redis cache backend <configure/environment-configuration-settings:redis cache backend>` configuration settings documentation for details.

Copy link
Member Author

Choose a reason for hiding this comment

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

I don't know, this was already there. Will defer to Carrie.

Comment on lines 49 to 58
Example
~~~~~~~

A 100000-person team with medium usage (with a safety factor of 2x) would require between 10.56TB :sup:`1` and 52.8TB :sup:`2` of free space per annum.

:sup:`1` 100000 users * 5 MB * 12 months * 2x safety factor

:sup:`2` 100000 users * 25 MB * 12 months * 2x safety factor

We strongly recommend that you review storage utilization at least quarterly to ensure adequate free space is available.
Copy link
Member

Choose a reason for hiding this comment

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

Should this example be updated to 200k?

Copy link
Member

Choose a reason for hiding this comment

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

Yes please: the 100K inline references and the final calculation of free space

Copy link
Member Author

Choose a reason for hiding this comment

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

Will do

Copy link
Member

@cwarnermm cwarnermm left a comment

Choose a reason for hiding this comment

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

Approved with the assumption that the outstanding items noted in this PR are addressed. Really great job with this, @agnivade! Thank you!

@cwarnermm cwarnermm added Awaiting Submitter Action Blocked on the author 3: Reviews Complete All reviewers have approved the pull request and removed 1: Dev Review Requires review by a core commiter 2: Editor Review Requires review by an editor labels Mar 19, 2025
.. include:: ../_static/badges/ent-selfhosted.rst
:start-after: :nosearch:

This page describes the Mattermost reference architecture designed for the load of up to 200000 concurrent users. Unsure which reference architecture to use? See the :doc:`scaling for enterprise </scale/scaling-for-enterprise>` documentation for details.
Copy link
Contributor

Choose a reason for hiding this comment

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

Do we want to add here that 200k concurrent users translates to approximately 500k supported users, depending on expected usage?

Copy link
Member Author

Choose a reason for hiding this comment

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

IMO we should retire that heuristic. The ratio of concurrent:total varies highly from customer to customer. It is clearer to simply focus on concurrent users.

@agnivade agnivade removed the Awaiting Submitter Action Blocked on the author label Mar 20, 2025
Copy link

Newest code from mattermost has been published to preview environment for Git SHA 354fc32

@agnivade
Copy link
Member Author

/update-branch

Copy link

Newest code from mattermost has been published to preview environment for Git SHA c834532

@agnivade agnivade merged commit f65a5f6 into master Mar 20, 2025
4 checks passed
@agnivade agnivade deleted the sbir200K branch March 20, 2025 05:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
3: Reviews Complete All reviewers have approved the pull request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants