Skip to main content
This page covers the status workflow and file attachment behavior for Data Review Annotations, and the creation, Rule, and Family behavior of Phase Annotations, described in Phase Annotations below. See Annotation fields for the fields available when creating either type.

​
Statuses

The following statuses apply to Data Review Annotations only. Phase Annotations have no status.

​
Transitioning between states

Use the status control in the Annotation details panel to transition an Annotation between Open, Failed, and Accepted. All state transitions are recorded in the Annotation’s activity log with a timestamp and the user who made the change.

​
How Annotation states appear in Reports

When a Rule is evaluated in a Report, the status displayed for that Rule is derived from the states of its Annotations:
  • If all Annotations are Open: the Rule shows as Open.
  • If at least one Annotation is Failed: the Rule shows as Failed, regardless of other Annotation states.
  • If all Annotations are Accepted: the Rule shows as Accepted.
  • If the Rule generated no Annotations: the Rule shows as Passed. Passed Rules are not shown in the Report by default; filter for Passed Rules to see them.
Changing an Annotation’s state immediately updates the Rule’s displayed status in the Report. A Rule that generated a Phase Annotation is hidden from the Report’s Rules panel by default, since Phase Annotations carry no Open, Failed, or Accepted state. Select All in the Rules panel filter to view the Rule and its Phase Annotation.

​
File attachments

Files can be attached to Annotations and to individual comments on Annotations.

​
Supported file types

​
Size limits

​
Phase Annotations

A Phase Annotation marks a period or stage in a Run, such as “Engine Ignition” or “Max-Q.” Unlike a Data Review Annotation, a Phase Annotation has no status, cannot be assigned to a user, and does not support file attachments.

​
Create a Phase Annotation

Create a Phase Annotation manually in Explore using the Annotations tab or the Select X tool. See Investigate a telemetry anomaly for the steps, and Annotation fields for the available fields. A Rule can also generate a Phase Annotation instead of a Data Review Annotation when its condition evaluates to true, marking a period rather than flagging an issue for triage. In the Rule editor’s Annotation Details section, select Phase instead of Data Review to configure this.

​
Use in Families

An Annotation alignment on a Family resolves T-0 to the timestamp of a matching Annotation on each Run. Phase Annotations are the type used for this purpose, since they mark a named event without requiring the review status fields a Data Review Annotation carries. See Configure alignments.

​
API behavior

Phase Annotations are created, retrieved, and updated through the same Annotation API as Data Review Annotations, distinguished by the annotation_type field. A Phase Annotation’s state field must be left unset; setting it returns an error.

​
Behavior

To open a specific Annotation directly, use its ID in the URL: https://app.siftstack.com/annotation/<annotation-id>.