Skip to content

Revisions

Overview

Revisions in Osprey provide automatic change tracking and version control for industrial assets. Each revision is a snapshot of an asset's configuration at the moment it changed, letting you see exactly what changed, when it changed, and compare versions side-by-side.

What Are Revisions?

Revisions are complete asset snapshots created whenever Osprey detects a change. Each snapshot includes:

  • Version number (sequential)
  • Timestamp (when change was detected)
  • Complete configuration (all properties and metadata)
  • Visual diff highlighting additions, deletions, and modifications

What Gets Tracked

Asset Type Revision Captures
PI Tags Entire tag configuration (e.g., data type, compression settings, scaling, Performance Equation or Totalizer configuration, etc.)
PI AF Elements Any change to element configuration (e.g., name, description, hierarchy)
PI AF Attributes Any change such as data reference, data type, units of measure, formula updates
PI AF Analyses Changes to expressions, scheduling, input references, or other analysis settings
Custom Assets Full configuration snapshots for manually curated asset types uplaoded to Osprey

How Revisions Work

  1. Osprey scans and compares assets against the last known state
  2. If a change is detected, a new revision is created and assigned the next version number
  3. A full snapshot of the asset is stored, and a visual diff is generated against the previous version

Using Revisions

  1. Open any asset detail page → Revisions tab
  2. Browse the revision history in a table (version, timestamp)
  3. Click a row to open the visual diff viewer, which shows color-coded changes

Common Use Cases

  • Troubleshooting: Quickly identify when a configuration changed that caused a tag or calculation to break
  • Compliance: Generate an audit trail showing what changed and when
  • Rollback Planning: Find the last known good configuration to guide recovery

Summary

Revisions provide a time machine for your PI System configurations. By automatically capturing and preserving every change, Osprey helps you troubleshoot faster, document compliance, and maintain confidence in how your systems evolve.