Skip to content

docs(monitoring): use alloy instead of promtail#260

Open
ma-hartma wants to merge 4 commits into
mainfrom
monitoring-alloy
Open

docs(monitoring): use alloy instead of promtail#260
ma-hartma wants to merge 4 commits into
mainfrom
monitoring-alloy

Conversation

@ma-hartma
Copy link
Copy Markdown

@ma-hartma ma-hartma commented May 6, 2026

Description

Update monitoring docs to reflect metal-stack/metal-roles#552.
Only merge this, after metal-stack/metal-roles#592 and metal-stack/metal-roles#595 are merged and released.

Used AI-Tools ✨

  • Claude Sonnet 4.6 for wording

References:

@ma-hartma ma-hartma requested a review from a team as a code owner May 6, 2026 14:07
@metal-robot metal-robot Bot added the area: documentation Affects the documentation area. label May 6, 2026
@metal-robot metal-robot Bot added this to Development May 6, 2026
@netlify
Copy link
Copy Markdown

netlify Bot commented May 6, 2026

Deploy Preview for metal-stack-io ready!

Name Link
🔨 Latest commit 1e9798b
🔍 Latest deploy log https://app.netlify.com/projects/metal-stack-io/deploys/6a0dcdfd849c220007255f7f
😎 Deploy Preview https://deploy-preview-260--metal-stack-io.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@ma-hartma ma-hartma marked this pull request as draft May 8, 2026 13:44
@ma-hartma ma-hartma marked this pull request as ready for review May 19, 2026 16:08
Copy link
Copy Markdown
Contributor

@vknabel vknabel left a comment

Choose a reason for hiding this comment

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

Just a few nits. Waiting for review and merge of actual changes before a full approve.


In-cluster components are scraped by Prometheus via `ServiceMonitor` resources (pull model).
Alloy self-metrics use a different approach: the control-plane Alloy DaemonSet and all Gardener seed Alloy instances push their metrics via `prometheus.remote_write` to Thanos Receive (`monitoring_thanos_receive_enabled: true`), removing the need for Prometheus to reach into each cluster.
Alloy self-metrics use a different approach — no ServiceMonitor required:
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
Alloy self-metrics use a different approach — no ServiceMonitor required:
Alloy self-metrics use a different approach that does not require a `ServiceMonitor`:

Alloy self-metrics use a different approach: the control-plane Alloy DaemonSet and all Gardener seed Alloy instances push their metrics via `prometheus.remote_write` to Thanos Receive (`monitoring_thanos_receive_enabled: true`), removing the need for Prometheus to reach into each cluster.
Alloy self-metrics use a different approach — no ServiceMonitor required:

- The **control-plane Alloy** DaemonSet pushes metrics via `prometheus.remote_write` to the in-cluster Thanos Receive. Wired automatically when `monitoring_thanos_receive_enabled: true`.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
- The **control-plane Alloy** DaemonSet pushes metrics via `prometheus.remote_write` to the in-cluster Thanos Receive. Wired automatically when `monitoring_thanos_receive_enabled: true`.
- The **control-plane Alloy** `DaemonSet` pushes metrics via `prometheus.remote_write` to the in-cluster Thanos Receive. Wired automatically when `monitoring_thanos_receive_enabled: true`.

Alloy self-metrics use a different approach — no ServiceMonitor required:

- The **control-plane Alloy** DaemonSet pushes metrics via `prometheus.remote_write` to the in-cluster Thanos Receive. Wired automatically when `monitoring_thanos_receive_enabled: true`.
- **Gardener seed Alloy** instances have no local Prometheus, so they push metrics to the control-plane Thanos Receive ingress instead. Wired automatically when `monitoring_thanos_receive_ingress_enabled: true`.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
- **Gardener seed Alloy** instances have no local Prometheus, so they push metrics to the control-plane Thanos Receive ingress instead. Wired automatically when `monitoring_thanos_receive_ingress_enabled: true`.
- **Gardener seed Alloy** instances have no local Prometheus and push their metrics to the control-plane Thanos Receive ingress instead. Wired automatically when `monitoring_thanos_receive_ingress_enabled: true`.
- ```

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

Labels

area: documentation Affects the documentation area.

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

2 participants