PI Nexus+ / User Guide
PI Interfaces
This chapter shows how to see which legacy PI Interfaces feed which PI Points, and whether each interface is configured correctly, delivering good data and running.
Overview
This chapter shows how to see which legacy PI Interfaces feed which PI Points, and whether each interface is configured correctly, delivering good data and running.
The page fills after a PI Point, Full Inventory or PI Interfaces scan, once an administrator has turned on Interface Tracking for the PI Data Archive. Live runtime health also needs Runtime Monitoring (see PI Data Archives in the Administration Guide).
Concepts
Each interface has three health columns. Read them separately:
| Column | Tells you | Comes from |
|---|---|---|
| Configuration | Whether the Module Database and the PI Point settings (PointSource, interface ID, Location values, scan classes) agree | PI Interface Health step of every PI Point inventory and health refresh scan |
| Data Health | The rolled-up health of the PI Points the interface feeds | Same as above |
| Runtime | Whether the interface itself runs: heartbeat, device status, scan-class performance | Runtime poll, every minute by default |
An idle interface is not unhealthy: zero throughput raises nothing. Setup required means no heartbeat or device-status PI Point is mapped yet; an administrator maps one with Monitoring setup in the dialog's More actions menu.
Check a PI Interface
- Open PI Interfaces, click a card such as Runtime to show the interfaces that need attention, and click a row. Read Configuration, Data Health, Runtime and Mapped PI Points; the Runtime card names the reason.
- Open Runtime: the current Device status, Heartbeat age, I/O rate and the other UniInt signals, the Process resources and the latest Runtime transitions.
- Read each signal's state and age. A stale heartbeat or a device status that is not Good is what raises PI Interface Runtime Health.
- After fixing the interface, choose Check health. It re-reads this interface from the Module Database and refreshes all three columns.
When the page shows a not refreshing banner, the runtime poll has stopped; the runtime status shown is the last known one. Ask an administrator to check the scanner service.
Find which interface feeds a PI Point
- On PI Points, read the Interface column, or filter by PI Interface, Processing mode or Scan class.
- On Point Sources, read Fed by (see Point Sources).
- In an interface's Connections tab, search for the point.
A point whose PointSource and interface ID match no interface raises Unmapped PI Point Interface; one that matches two raises Ambiguous PI Point Interface.
Recalculate after an interface outage
In the interface dialog, open the More actions menu and choose Recalculate analyses to see the analyses that use its points, then continue as in Recalculate after an outage in AF Analyses and Recalculation. Interface membership does not prove every point lost data.
Reference: PI Interface Issues and Runtime
