Documentation PI Nexus+ Documentation

PI Nexus+ / Reference

Servers and Sites Reference

This reference lists the service health rules, the columns and dialogs of the Servers page, and how objects belong to sites. The User Guide chapter Servers and Sites links here. The Hosts tab is described in Host Monitoring Reference.

Overview

This reference lists the service health rules, the columns and dialogs of the Servers page, and how objects belong to sites. The User Guide chapter Servers and Sites links here. The Hosts tab is described in Host Monitoring Reference.

Service health rules

A server's service health is the worst of all reasons that apply. Order: Error, Warning, Unknown, Good. Each reason is listed in the server's dialog; the first is shown on the row.

StateReason (as shown)Applies to
Not monitoredNo longer a scan target. Counts are from the last scan.All
Not monitoredDisabled as a scan target.All
ErrorThe last connection test failed.All
ErrorThe last N scans failed (3 or more in a row, inventory or health)PI Data Archive, AF Database
WarningThe last scan failed / The last 2 scans failedPI Data Archive, AF Database
WarningNo successful health refresh since a time. Raised when the last success is older than 3 times the target's health cadence, and only while automatic monitoring is active and the target is included and not pausedPI Data Archive, AF Database
WarningScan automation reports that the target needs attention (its reason is shown)PI Data Archive, AF Database
WarningThe change feed is failing; changes are picked up by full scans only.PI Data Archive, AF Database
WarningThe change feed must be re-established by a full scan.PI Data Archive, AF Database
WarningThe last PI Interface inventory failed.PI Data Archive
WarningThe last PI Interface runtime poll failed.PI Data Archive
Error / WarningN AF databases have service health Error / WarningAF Server
UnknownNever tested and never scanned.All
GoodNone of the aboveAll

An AF Server has no scans of its own: its service health combines its connection test with its AF databases. A database with Unknown service health does not change the server. A PI Vision instance is judged only on being enabled and its connection test. An old inventory scan is never a service health reason.

Servers page tabs

TabColumnsRow actions
PI Data ArchivesPI Data Archive (and version), Service Health, PI Points, Point Sources, PI Interfaces, PI AdaptersShow PI Points, Show Point Sources, Show PI Interfaces
AF ServersAF Server, Service Health, AF Databases, AF Attributes, AF AnalysesShow AF Databases
AF DatabasesAF Database, Service Health, AF Attributes, AF Analyses, AF Elements, Last Health RefreshShow AF Attributes, Show AF Analyses, Show AF Elements
PI VisionPI Vision Instance, Service Health, PI Vision Displays, Last InventoryShow PI Vision Displays
HostsSee Host Monitoring Reference

A Site column is added under All sites when there are two or more sites. The selected tab is part of the page address, so a shared link opens the same tab.

CardShows
All PI Data Archives / All AF Servers / All AF Databases / All PI Vision InstancesEvery row matching the filters
Service ErrorServers PI Nexus+ cannot reach or keep current
Service WarningServers with failing scans, stale health or a failing change feed
With Bad PI Points / With Bad AF objects / With Display ErrorsServers whose content includes Bad or Error objects
FilterOptions
Service healthAny, Error, Warning, Good, Unknown, Not monitored
AF ServerAF Databases tab only; the AF Servers of the chosen site
ShowMonitored (default), Also not monitored

Servers CSV export

ItemRule
RoleOperator; locked in the Evaluation edition
RowsEvery row of the tab in the chosen site, including servers that are not monitored. Search, filters and cards are ignored
ColumnsAlways includes Site. The PI Data Archive file also has the reasons, last inventory, last health refresh and change-feed state

Server dialogs

DialogTabs
PI Data ArchiveOverview, Point Sources, PI Interfaces, PI Adapters, PI Points
AF ServerOverview, AF Databases, Analytics
AF DatabaseOverview, Elements, Templates, Attributes, Analyses, Analytics
PI Vision InstanceOverview, Displays, Data Sources

Server dialogs have no Issues or Change History tab. Overview shows the service health reasons, content health, details (site, version), the Host section when the server's host is monitored, and Scanning (last inventory, last health refresh, change-feed state).

Analytics itemMeaning
Estimated loadSum over the analyses of average run time divided by trigger interval, from the Analysis Service statistics. An estimate, not a measurement. None measured without statistics
Estimated runtime per dayThe analyses' estimated total run time per day
Performance warnings / Performance errorsAnalyses with those performance findings
Costliest AnalysesThe 5 active analyses with the highest estimated runtime per day

Site membership

ObjectBelongs to
PI Data Archive, AF Server, PI Vision instanceThe site chosen by an administrator; Default unless changed
AF database, AF elements, attributes, analyses, templatesThe site of their AF Server
PI Points, PointSources, PI InterfacesThe site of their PI Data Archive
PI Adapter CollectorsThe site of the AF Server holding their AF monitoring database
PI Vision displaysThe site of their instance
Objects on a server that is not a registered targetNo site; shown under All sites only
RuleValue
Default siteAlways exists; can be renamed, not deleted. Servers of a deleted site move to it. Hidden from the Site list while nothing is assigned to it
Sites visibleFrom two sites on
Site content healthCovers everything its servers and PI Vision instances hold
Site service healthThe worst service health of its monitored PI Data Archives, AF Servers and PI Vision instances

Creating sites and assigning servers: Sites in the Administration Guide.