Skip to content

CanaryPolicy

← All HTTP schemas

Defines automatic rollback and gradual traffic-increase rules for an experiment canary variant.

Shape: object

Property Required Type Description Rules
canaryVariant yes string Gets the canary variant name. It must exist in the experiment Variants list.
maxErrorRateDelta no number (double) Gets the maximum absolute error-rate difference from the control, from 0.0 through 1.0. The canary rolls back when its rate is higher. No error-rate check runs when this value is null. pattern `^-?(?:0\
minScore no integer (int32) Gets the minimum average canary score from 0 through 100. The canary rolls back below this threshold. No score check runs when this value is null. pattern `^-?(?:0\
minSampleSize no integer (int32) Gets the minimum completed run count that both the canary and control variants must reach before a decision is made. pattern `^-?(?:0\
rampSteps no array of integer (int32) Gets the canary-weight steps that increase over time, for example [5, 25, 50, 100]. An empty list disables gradual increases. The canary weight stays at the value set through SaveAsync and only rollback is evaluated.
rampInterval no string Gets the minimum time between steps. pattern ^-?(\d+\.)?\d{2}:\d{2}:\d{2}(\.\d{1,7})?$