[CASSANDRA-17147] Guardrails prototype

• Type: New Feature
• Status: Resolved
• Priority: Normal
• Resolution: Fixed
• Fix Version/s: 4.1-alpha1, 4.1
• Component/s: Feature/Guardrails
• Epic Link: CEP-3: Guardrails
• Change Category: Operability
• Complexity: Challenging
• Platform: All

Source Control Link

https://github.com/apache/cassandra/commit/7871a2854217acc89d2f885619243a442cf68e22

Test and Documentation Plan

The PR includes tests for each new guardrail and for the framework itself.

• Assignee: Andres de la Peña
• Reporter: Andres de la Peña

Authors

Andres de la Peña

Reviewers

David Capwell, Stefan Miklosovic

• Created: 15/Nov/21 15:58
• Updated: 27/May/22 19:25
• Resolved: 03/Dec/21 15:30

Description

The purpose of this ticket is creating an initial implementation of the guardrails framework, as well as adding a few simple guardrails using this framework.

To keep things easy, this initial implementation would only support guardrails that are triggered on the coordinator, and they would be dynamically updatable only through JMX.

Once we have this initial framework ready in a feature branch we can have multiple tickets addressing all the things that would have been left out of the scope of this ticket, such as:

• Dynamic updates through virtual tables
• Being able to notify about guardrails triggered on replicas
• Using custom exceptions other than InvalidRequestException.
• Porting existing limits to use the new guardrails framework
• Adding new guardrails beyond the initial ones

The reason for having this simpler prototype is that it will give us a common ground to parallelize work on the parts mentioned above.

Issue Links

• is related to: CASSANDRA-17195 Migrate thresholds for number of keyspaces and tables to guardrails
• is required by: CASSANDRA-17150 Guardrails for disk usage
• is required by: CASSANDRA-17152 Guardrail for partition size
• is required by: CASSANDRA-17153 Guardrails for collection items and size
• is required by: CASSANDRA-17154 Guardrail to disable read-before-write list operations
• is required by: CASSANDRA-17212 Migrate threshold for minimum keyspace replication factor to guardrails
• is required by: CASSANDRA-17148 Adapt track_warnings to Guardrails
• is required by: CASSANDRA-17149 Make Guardrails configurable through virtual tables