Skip to content

alerts: Add "Ring Failures" to MimirCompactorNotRunningCompaction runbook#14391

Open
juliusmh wants to merge 1 commit intomainfrom
jmh/adjust_MimirCompactorNotRunningCompaction
Open

alerts: Add "Ring Failures" to MimirCompactorNotRunningCompaction runbook#14391
juliusmh wants to merge 1 commit intomainfrom
jmh/adjust_MimirCompactorNotRunningCompaction

Conversation

@juliusmh
Copy link
Contributor

@juliusmh juliusmh commented Feb 17, 2026

What this PR does

This PR adjusts the CompactorNotRunningCompaction runbook to contain a section on "Ring Failures".

Checklist

  • [n/a] Tests updated.
  • Documentation added.
  • CHANGELOG.md updated - the order of entries should be [CHANGE], [FEATURE], [ENHANCEMENT], [BUGFIX]. If changelog entry is not needed, please add the changelog-not-needed label to the PR.
  • [n/a] about-versioning.md updated with experimental features.

Note

Low Risk
Documentation-only update (runbook text plus changelog entry) with no code or runtime behavior changes.

Overview
Adds a new Ring failures troubleshooting section to the MimirCompactorNotRunningCompaction runbook, including detection steps (log search for unhealthy instances and checking the compactor ring status page) and mitigation guidance (typically transient; optionally forget unexpected Unhealthy instances).

Updates CHANGELOG.md to record this documentation enhancement.

Written by Cursor Bugbot for commit 10bb980. This will update automatically on new commits. Configure here.

@juliusmh juliusmh requested review from a team and tacole02 as code owners February 17, 2026 12:48
@juliusmh juliusmh self-assigned this Feb 17, 2026
cursor[bot]

This comment was marked as outdated.

@github-actions
Copy link
Contributor

github-actions bot commented Feb 17, 2026

💻 Deploy preview available (alerts: Adjust MimirCompactorNotRunningCompaction to fire after 10 minutes of sustained failures):

@cursor

This comment was marked as outdated.

@juliusmh juliusmh force-pushed the jmh/adjust_MimirCompactorNotRunningCompaction branch from 8ec5710 to a22f17b Compare February 17, 2026 13:15
@juliusmh juliusmh changed the title alerts: Adjust MimirCompactorNotRunningCompaction to fire after 10 minutes of sustained failures alerts: Add "Ring Failures" to MimirCompactorNotRunningCompaction runbook Feb 17, 2026
@juliusmh juliusmh force-pushed the jmh/adjust_MimirCompactorNotRunningCompaction branch from a22f17b to edae79c Compare February 17, 2026 13:24
@github-actions
Copy link
Contributor

github-actions bot commented Feb 17, 2026

💻 Deploy preview available (alerts: Add "Ring Failures" to MimirCompactorNotRunningCompaction runbook):

@juliusmh juliusmh force-pushed the jmh/adjust_MimirCompactorNotRunningCompaction branch from edae79c to ae7c59f Compare February 17, 2026 13:52
Copy link
Contributor

@tacole02 tacole02 left a comment

Choose a reason for hiding this comment

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

Docs look good! Thank you!

- Search compactor logs for `unhealthy instances`.
- Check the [compactor ring web page](../../references/http-api/#compactor-ring-status) for unhealthy instances.
- **What it means**: The compactor ring contains unhealthy instances and compactor(s) cannot check the tenant-shard relationship.
- **How to mitigate**: Ring failures are typically transient and the alert self-resolves after ten minutes. Otherwise: consider manually forgetting unexpected instances in an `Unhealthy` state on the compactor ring web page.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Ring failures are typically transient and the alert self-resolves after ten minutes

Uhm... then the alert shouldn't trigger in the first place. Let's discuss it offline.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Ah yeah, this comment is wrong. Updated it.

@juliusmh juliusmh force-pushed the jmh/adjust_MimirCompactorNotRunningCompaction branch from ae7c59f to 10bb980 Compare February 17, 2026 17:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

Comments