Skip to main content
Documentation

Evaluations

Files.com records an Evaluation for every closed window. The Evaluations for an Expectation provides a history of past windows and their outcomes, including the evidence that explains each result.

A result includes which files were matched, how many, their combined size, and which criteria failed and why.

An Evaluation will open an Incident when a scheduled window fails and no Incident is already open for the associated Expectation.

You can view the Evaluations for a specific Expectation from its detail page.

Evaluation Timing

Files.com evaluates Expectations on a periodic schedule. Power plan sites are evaluated approximately every 15 minutes. Premier and Enterprise plan sites are evaluated approximately every 5 minutes.

Evaluations results are derived from file timestamps, not from when the evaluator runs. If your due time is 06:00 and the evaluation runs at 06:02, the due time deadline is still recorded as 06:00.

Details Recorded in Evaluations

Evaluations contain the following information about each closed window.

ITEMDETAILS
StatusThe status or result of the window: Open, Success, Late, Missing, or Invalid.
Opened ViaThe trigger type that was used to open the Expectation window.
Opened AtThe time that the evaluation was started.
Window StartThe start time of the evaluation window.
Window EndThe time at which the window closed.
DeadlineThe scheduled deadline for this window, if applicable.
Late CutoffThe latest time files could arrive and still result in a Late outcome, if a late acceptance interval is configured.
Updated AtThe time that the evaluation was last updated.
Closed AtThe time that the evaluation finished.
Hard CloseThe hard stop time, after which the window may not remain open.
MatchedThe total number of files matched.
MissingThe total number of expected files that are missing.
ErrorsThe number of errors.
SummaryA summary showing the number of matched files, the number of matched bytes, and the outcome for the criteria.
Criteria ErrorsDetails of which criteria were not satisfied, including the specific rules that were violated.