# CanaryEvaluation

> Tracon documentation. Tracon is a .NET package family that adds a control
> plane on Microsoft Agent Framework, published as NuGet packages that run
> inside your own ASP.NET Core application.
>
> Page: https://tracon.dev/http-api/schemas/canaryevaluation/
> Summary: OpenAPI request or response schema for CanaryEvaluation, including required fields, defaults, constraints, and linked nested types.

[← All HTTP schemas](/http-api/schemas/)

Represents the result of evaluating a canary policy against the current results
of the canary and control variants.

**Shape:** `object`

| Property | Required | Type | Description | Rules |
|---|---|---|---|---|
| `decision` | yes | [`CanaryDecisionKind`](/http-api/schemas/canarydecisionkind/) | Gets the evaluation outcome. | — |
| `reason` | yes | `string` | Gets the human-readable reason for the decision. | — |
| `canary` | no | `null` oneOf [`ExperimentVariantResult`](/http-api/schemas/experimentvariantresult/) | — | — |
| `control` | no | `null` oneOf [`ExperimentVariantResult`](/http-api/schemas/experimentvariantresult/) | — | — |
| `evaluatedAt` | yes | `string (date-time)` | Gets the UTC time when the evaluation occurred. | — |