Skip to content

chore: replace control-plane promtail with alloy - #595

Merged
Gerrit91 merged 35 commits into
masterfrom
promtail-alloy-migration-control-plane
Jun 16, 2026
Merged

chore: replace control-plane promtail with alloy#595
Gerrit91 merged 35 commits into
masterfrom
promtail-alloy-migration-control-plane

Conversation

@ma-hartma

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

Copy link
Copy Markdown
Contributor

Description

Replaces promtail with alloy in the control-plane.
The partition replacement is treated separately in #592 and should go first.

Question Marks:

After successful replacement

  • update monitoring docs for the website
  • migration guide
    • convert does not work with helm chart
  • deprecate promtail roles

Manually tested in the mini-lab and demo-rack

  • metrics are pushed to thanos, accessible via Grafana
  • labels work as documented and before
  • cutover migration from promtail to alloy in the mini-lab including cleanup
  • deprecation warnings show up

Still needs to be tested:

  • enable Service Monitors

References:

Closes #552

Used AI-Tools ✨

  • Claude Sonnet 4.6 for docs and migration guide generation and jinja templating

Release Notes

Breaking Change

The event `job` label was renamed from `monitoring/event-exporter` to `events`. Update any existing LogQL queries, dashboard filters, and alert rules that reference `{job="monitoring/event-exporter"}` to `{job="events"}`.

The monitoring role's basic auth configuration for `Thanos Receive Ingress` has changed. The raw `htpasswd` string `monitoring_thanos_receive_ingress_basic_auth` has been replaced by two plaintext variables `
monitoring_thanos_receive_ingress_basic_auth_user: thanos-receive` and `monitoring_thanos_receive_ingress_basic_auth_password: mysecret`.
See: https://github.com/metal-stack/metal-roles/blob/master/control-plane/roles/monitoring/README.md#thanos-receive-ingress-credentials

Required Actions

The control-plane `logging` role now deploys Grafana `Alloy` as the default log collector. Alloy needs to be configured before running the new version of the role, as the deprecated `Promtail` DaemonSet and the `event-exporter` resources are disabled and removed by default.

Follow the migration instructions:
- https://github.com/metal-stack/metal-roles/blob/master/control-plane/roles/logging-common/README.md#migration-from-promtail

Several migration scenarios are supported — from a hard cutover to a parallel run for verification before switching over. Note that running both simultaneously will produce duplicate log entries in Loki during the transition window. 

@metal-robot metal-robot Bot added this to Development May 4, 2026
@ma-hartma
ma-hartma requested a review from simcod May 4, 2026 20:38
@ma-hartma ma-hartma changed the title feat: introduce alloy role to replace promtail in control-plane feat: replace control-plain promtail with alloy May 5, 2026
@ma-hartma ma-hartma changed the title feat: replace control-plain promtail with alloy feat: replace control-plane promtail with alloy May 5, 2026
@ma-hartma
ma-hartma force-pushed the promtail-alloy-migration branch 2 times, most recently from 78c5ad6 to 04731eb Compare May 6, 2026 13:43
@ma-hartma ma-hartma changed the title feat: replace control-plane promtail with alloy chore: replace control-plane promtail with alloy May 6, 2026
@ma-hartma
ma-hartma changed the base branch from promtail-alloy-migration to master May 8, 2026 06:23
@ma-hartma
ma-hartma force-pushed the promtail-alloy-migration-control-plane branch 2 times, most recently from 413e4cc to 8ef1443 Compare May 8, 2026 13:07
@ma-hartma
ma-hartma marked this pull request as ready for review May 8, 2026 13:09
@ma-hartma
ma-hartma requested review from a team as code owners May 8, 2026 13:09
@ma-hartma
ma-hartma force-pushed the promtail-alloy-migration-control-plane branch from 4d6686b to 8597f82 Compare May 8, 2026 13:43
Comment thread control-plane/roles/logging-common/templates/alloy-config.alloy.j2
Comment thread control-plane/roles/logging/defaults/main.yaml
@ma-hartma
ma-hartma marked this pull request as draft May 19, 2026 07:47
@ma-hartma
ma-hartma force-pushed the promtail-alloy-migration-control-plane branch from 1040276 to d92490b Compare May 19, 2026 11:16
@ma-hartma
ma-hartma marked this pull request as ready for review May 19, 2026 12:12
Comment thread control-plane/roles/logging-common/templates/alloy-config.alloy.j2 Outdated
Comment thread control-plane/roles/logging/defaults/main.yaml Outdated
Comment thread control-plane/roles/logging/defaults/main.yaml Outdated
@ma-hartma
ma-hartma requested a review from simcod June 8, 2026 13:30
@ma-hartma
ma-hartma force-pushed the promtail-alloy-migration-control-plane branch from 0a268e3 to 992295d Compare June 8, 2026 13:41
Comment thread control-plane/roles/logging/defaults/main.yaml Outdated
Comment thread control-plane/roles/logging/tasks/main.yaml Outdated
Comment thread control-plane/roles/logging-common/templates/alloy-config.alloy.j2 Outdated
Comment thread control-plane/roles/logging/templates/alloy-values.yaml Outdated
Comment thread control-plane/roles/logging/README.md Outdated
Comment thread control-plane/roles/logging/README.md Outdated
Comment thread control-plane/roles/monitoring/defaults/main.yaml
@ma-hartma
ma-hartma requested a review from Gerrit91 June 12, 2026 09:45
Comment thread control-plane/roles/monitoring/tasks/main.yaml
Comment thread control-plane/roles/logging-common/defaults/main.yaml Outdated
Comment thread control-plane/roles/logging-common/tasks/deploy-alloy.yaml
@Gerrit91
Gerrit91 merged commit 2aa9856 into master Jun 16, 2026
6 checks passed
@Gerrit91
Gerrit91 deleted the promtail-alloy-migration-control-plane branch June 16, 2026 12:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Archived in project

Development

Successfully merging this pull request may close these issues.

Introduce Alloy as promtail Replacement

3 participants