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

Blog article submission: Life of a Sample in Thanos Part I #7748

Merged
merged 8 commits into from
Sep 18, 2024

Conversation

thibaultmg
Copy link
Contributor

  • I added CHANGELOG entry for this change.
  • Change is not relevant to the end user.

Changes

When I started using Thanos, it took me some time to understand how all the components work and how to configure them properly. The interdependencies within the complete system can be complex.

In this series of three articles (this PR is for the first one), I aim to provide a comprehensive view of the system and how to configure it by following a metric's sample from its ingestion to retrieval.

I hope you will find this a valuable addition to the blog and that it will help new users adopt Thanos more easily by smoothing the learning curve.

If there are any inaccuracies or important missing elements, please let me know.

To make the review process easier, and because the other articles are still in progress, I am splitting the submission into three separate pull requests, one per article.

Verification

Signed-off-by: Thibault Mange <22740367+thibaultmg@users.noreply.github.com>
Signed-off-by: Thibault Mange <22740367+thibaultmg@users.noreply.github.com>
Copy link
Contributor

@pedro-stanaka pedro-stanaka left a comment

Choose a reason for hiding this comment

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

LG - small nits. But the write up is very nice and really liked the drawings!

docs/blog/2023-11-20-life-of-a-sample-part-1.md Outdated Show resolved Hide resolved
docs/blog/2023-11-20-life-of-a-sample-part-1.md Outdated Show resolved Hide resolved
docs/blog/2023-11-20-life-of-a-sample-part-1.md Outdated Show resolved Hide resolved
docs/blog/2023-11-20-life-of-a-sample-part-1.md Outdated Show resolved Hide resolved
docs/blog/2023-11-20-life-of-a-sample-part-1.md Outdated Show resolved Hide resolved
Comment on lines 160 to 163
* [Life of a sample in thanos, and how to configure it – Ingestion – Part I](2023-11-20-life-of-a-sample-part-1.md)
* [Life of a sample in thanos, and how to configure it – Data Management – Part II](2023-11-20-life-of-a-sample-part-2.md)
* [Life of a sample in thanos, and how to configure it – Querying – Part III](2023-11-20-life-of-a-sample-part-3.md)

Copy link
Contributor

Choose a reason for hiding this comment

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

Those are going to fail CI. Better to remove links for now and mention that they will come.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Ack, removed them.

* **Compactor**: Merges and deduplicates blocks in object storage.
* **Store**: Exposes blocks in object storage for querying.
* **Query**: Retrieves data from stores and processes queries.
* **Query Frontend**: Distributes queries to query instances.
Copy link
Contributor

Choose a reason for hiding this comment

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

Can we add sidecar?

Copy link
Contributor

Choose a reason for hiding this comment

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

Or mention that we wont cover it in this guide?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I am covering it a bit, so I've added it here.
In the end I might also add the ruler, depending on what fits in part III. I'll add it here if needed.

thibaultmg and others added 6 commits September 17, 2024 16:00
Co-authored-by: Pedro Tanaka <pedro.tanaka@shopify.com>
Signed-off-by: Thibault Mange <22740367+thibaultmg@users.noreply.github.com>
Co-authored-by: Pedro Tanaka <pedro.tanaka@shopify.com>
Signed-off-by: Thibault Mange <22740367+thibaultmg@users.noreply.github.com>
Co-authored-by: Pedro Tanaka <pedro.tanaka@shopify.com>
Signed-off-by: Thibault Mange <22740367+thibaultmg@users.noreply.github.com>
Co-authored-by: Pedro Tanaka <pedro.tanaka@shopify.com>
Signed-off-by: Thibault Mange <22740367+thibaultmg@users.noreply.github.com>
Co-authored-by: Pedro Tanaka <pedro.tanaka@shopify.com>
Signed-off-by: Thibault Mange <22740367+thibaultmg@users.noreply.github.com>
Signed-off-by: Thibault Mange <22740367+thibaultmg@users.noreply.github.com>
Copy link
Contributor

@MichaHoffmann MichaHoffmann left a comment

Choose a reason for hiding this comment

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

Lgtm

Copy link
Member

@saswatamcode saswatamcode left a comment

Choose a reason for hiding this comment

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

Thanks a lot for this write up! Should help a lot of folks who are looking to gain a deeper understanding of the system! ❤️
And I love the diagrams (excalidraw ftw)!

@saswatamcode
Copy link
Member

Merging this one! Docs check fails due to medium 429s which is fine!

@saswatamcode saswatamcode merged commit 9dd7905 into thanos-io:main Sep 18, 2024
20 of 22 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants