Quantile Threshold Monthly (QtM)
YAML type: qtm | Category: Quantile
Compares monthly aggregates against a global monthly quantile.
Description
Distribution-based monthly alerts using historical monthly percentiles.
How it works

Quantile Monthly works like QtW on monthly aggregates: the current month is scored against a historical monthly percentile band.
You need enough months of history for a stable percentile. Useful for rare high or low months relative to the series' own past.
Setup
Requires enough months of history for a stable quantile.
Configure detectors on the data view Analysis tab or in YAML. Validate with Data Preview before enabling production schedules.
Settings
| Parameter | Default | Description |
|---|---|---|
percentile |
95 |
Monthly historical quantile |
mode |
above |
Direction -- see Allowed values |
aggregateMode |
sum |
Period aggregation -- see Allowed values |
Allowed values
mode
| Value | Meaning |
|---|---|
above |
Flag values above the quantile boundary |
below |
Flag values below the quantile boundary |
both is not implemented for quantile detectors (qt, qtw, qtm).
aggregateMode
Used when the detector compares period totals (week / month / quarter), not raw daily points.
| Value | Meaning |
|---|---|
sum |
Compare sums of daily values in the period (default) |
average |
Compare averages of daily values in the period |
Shared series filters
Most detectors also accept optional series filters in params:
| Parameter | Purpose |
|---|---|
maxGapAmount |
Skip series when gap amount is too high (null = no limit). Catalog create-default is often 5. |
minValue |
Skip series whose average value is below this (null = no limit). Catalog create-default is often 1000. |
maxValue |
Skip series whose average value is above this (optional; omit/null = no limit) |
useSpecialDates |
When true, suppress anomalies that overlap special dates |
When a filter skips a series, Data Preview shows the reason.
Configuration example
analysis:
detectors:
- type: qtm
params:
percentile: 90
mode: above
aggregateMode: sum
Using the detector
Useful for finance months that should stay within historical bands.
Use cases
- Monthly spend ceilings
- Rare high-month detection