drift-detector

Detect data and concept drift in Kafka anomaly scores using ADWIN and DDM detectors.

Updated Mar 3, 2026
One-click install
npx skills add https://github.com/GaneshMadarasu/real-time-anomaly-detection-pipeline --skill drift-detector-ganeshmadarasu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: drift-detector
Source: https://github.com/GaneshMadarasu/real-time-anomaly-detection-pipeline/tree/main/.claude/skills/drift-detector
Command: npx skills add https://github.com/GaneshMadarasu/real-time-anomaly-detection-pipeline --skill drift-detector-ganeshmadarasu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill explains how the drift-detector service catches data drift and concept drift in real-time anomaly scoring pipelines before degraded model quality turns into missed fraud or noisy alerts.

Core Features & Use Cases

  • Data drift monitoring: Tracks feature shifts in amount, amount z-score, and anomaly score using ADWIN detectors.
  • Concept drift detection: Uses DDM to watch prediction error rate against ground truth labels and flag model degradation.
  • Operational safeguards: Applies a Redis cooldown to prevent retraining spam, writes drift events in batches to TimescaleDB, and publishes alerts to Kafka topics.
  • Use case: Useful when a streaming fraud system needs to detect distribution changes, surface observability events, and trigger retraining only when drift is sustained.

Quick Start

Ask for a concise explanation of the drift-detector service behavior, including its drift logic, cooldown rules, and retraining trigger flow.

Frequently Asked Questions about drift-detector

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect data drift and concept drift in a real-time Kafka streaming pipeline?

To detect data drift and concept drift in a Kafka streaming pipeline, track feature distribution shifts using ADWIN detectors and monitor prediction error rates against ground truth labels using DDM. This approach catches degraded model quality before it impacts downstream applications.

What is the best way to prevent retraining spam when anomaly scores drift?

The best way to prevent retraining spam during anomaly score drift is to apply a Redis cooldown mechanism. This operational safeguard ensures retraining workflows are triggered only when drift is sustained, rather than firing on every transient feature distribution shift.

How does DDM monitor concept drift in anomaly scoring systems?

DDM monitors concept drift in anomaly scoring systems by watching the prediction error rate against ground truth labels. When the error rate degrades beyond a statistical threshold, DDM flags model degradation, allowing you to trigger necessary retraining workflows.

Can I use TimescaleDB to batch write drift events from a Kafka topic?

Yes, you can batch write drift events to TimescaleDB from a Kafka topic. This process manages drift events reliably by batching database writes alongside publishing alerts to Kafka topics and applying Redis cooldown control for sustained drift.

Does ADWIN work for detecting feature distribution shifts in streaming fraud detection?

Yes, ADWIN works for detecting feature distribution shifts in streaming fraud detection. It specifically tracks changes in transaction amount, amount z-score, and anomaly scores to catch data drift before missed fraud or noisy alerts occur.

When should I trigger retraining workflows in a real-time anomaly scoring pipeline?

You should trigger retraining workflows in a real-time anomaly scoring pipeline only when drift is sustained. By using ADWIN and DDM detectors alongside Redis cooldown control, you prevent retraining spam and ensure model degradation is addressed reliably.