Question 1

How does Quamina compare to using standard Go regex for JSON matching?

Accepted Answer

Quamina is optimized for structured JSON events with multiple patterns, offering faster matching for exact fields and nested conditions, while standard regex is slower and less intuitive for JSON. However, Quamina's regex support can degrade performance, so it's best for mixed use cases.

Question 2

How to implement custom flatteners for non-JSON formats like Avro in Quamina?

Accepted Answer

You need to implement the Flattener interface provided by Quamina to convert your event format into pathname/value pairs. The README mentions this for supporting Avro or Protobuf, but it requires manual coding without built-in helpers.

Question 3

What are the performance impacts of adding many patterns in Quamina?

Accepted Answer

Adding patterns is generally fast (tens of thousands per second), but performance can degrade with regex patterns or if fields are newly introduced. The README notes that matching speed is nearly O(1) for non-regex patterns but slows with complex ones.

Question 4

Can Quamina handle real-time event streaming with dynamic patterns?

Accepted Answer

Yes, it's designed for high-throughput scenarios, but dynamic pattern addition and deletion have costs. Use the Copy() API for concurrency, but be aware of warm-up behavior and potential rebuilds during deletions.

Question 5

Is Quamina thread-safe for concurrent event matching?

Accepted Answer

A single instance isn't thread-safe, but you can create copies using Copy() for parallel processing. The README specifies that copies are safe for concurrent MatchesForEvent(), AddPattern(), and DeletePattern() calls, with some performance penalties.

Question 6

How to delete patterns efficiently in Quamina without performance hits?

Accepted Answer

Enable pattern deletion with WithPatternDeletion, but accept the extra memory and occasional rebuilds. For minimal impact, batch deletions or avoid frequent changes, as the README admits this isn't free and plans improvements.

Quamina

What is Quamina?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions