Skip to content

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 Threshold Monthly (QtM) illustration

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