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

Docs: explain what are the "owned series" #9730

Open
colega opened this issue Oct 24, 2024 · 1 comment
Open

Docs: explain what are the "owned series" #9730

colega opened this issue Oct 24, 2024 · 1 comment
Assignees
Labels
type/docs Improvements or additions to documentation

Comments

@colega
Copy link
Contributor

colega commented Oct 24, 2024

Is your documentation request related to a feature? If so, which one?

In v2.12 we introduced an experimental feature called owned series tracking. There are however no docs explaining what are they, and why would someone want to use them instead of in-memory series.

Describe the solution that you’d like or the expected outcome

I would like to see docs explaining what owned series represent and what is the problem they're solving (I think the doc could start with the problem, and then introduce the concept of owned series).

@colega colega added the type/docs Improvements or additions to documentation label Oct 24, 2024
@colega colega changed the title Docs: explain what are _owned series_ Docs: explain what are the "owned series" Oct 24, 2024
@colega
Copy link
Contributor Author

colega commented Oct 24, 2024

This is an example I was giving someone on Slack:


Some series $S_1$, $S_2$ are sharded on ingester a-0 they're in-memory series.

Then we scale out ingesters and start a-1. $S_2$ is now pushed to these replicas, while $S_1$ stays on a-0 (I'm obviously oversimplifying sharding).

Now a-0 has 2 in-memory series: $S_1$ and $S_2$ until TSDB is compacted and $S_2$ is garbage-collected, but it only has 1 owned series: $S_1$, because it doesn't own $S_2$ anymore.

If we sum(in-memory) after scaling up, the result is 3: 2 from a-0, 1 from a-1, but customer is still pushing only 2 series.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
type/docs Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

2 participants