Raft Metadata Apply Errors Indicate Controller Issues
criticalreliabilityUpdated Mar 2, 2026
In KRaft mode, metadata apply errors indicate the controller is failing to apply metadata changes, potentially causing inconsistent cluster state.
Technologies:
How to detect:
Monitor kafka.raft.metadata_apply_error_count or kafka.raft.metadata_load_error_count increasing. Any non-zero value requires immediate investigation.
Recommended action:
1. Check controller logs: Review logs for specific error messages. 2. Verify disk health: Ensure metadata log storage is healthy. 3. Check controller quorum: Verify all controller nodes are participating in quorum. 4. Review recent metadata changes: Identify what change triggered the error. 5. Monitor kafka.raft.current_leader: Ensure stable leadership. 6. Check for version conflicts: Verify all controllers are running compatible versions.