PI Nexus+ / Reference
Health and KPI Calculation
This reference lists the health states, how an object's health follows its issues, how the dashboard percentages are calculated, and the rules for suppressing issues. The User Guide chapters Health, Issues and KPIs and Investigate an Issue link here.
Overview
This reference lists the health states, how an object's health follows its issues, how the dashboard percentages are calculated, and the rules for suppressing issues. The User Guide chapters Health, Issues and KPIs and Investigate an Issue link here.
Health states
| State (as shown) | Applies to | Meaning |
|---|---|---|
| Good | All objects | No open, unsuppressed Error or Warning issue |
| Warning | All objects | The newest open, unsuppressed issue of the worst severity is a Warning |
| Bad | PI Points | An open, unsuppressed Error issue |
| Error | AF Attributes, AF Analyses, PI Vision displays | An open, unsuppressed Error issue |
| Not Evaluated | PI Points, AF Attributes, AF Analyses, PI Vision displays | No current verdict: missing from the latest scan, excluded by a PI Point rule, above the licensed PI Point capacity, or (analyses) disabled, stopped or not ready |
| Unknown | PI Points, AF Attributes | The value's quality could not be determined |
| No Health Sources | AF Elements only | The element has no attributes or analyses that carry health |
| No status | Dependency graph nodes only | The node has no health, for example a calculation or an external source |
Suppressed is not a health state. It marks an issue that is hidden from counts.
How health follows issues
| Rule | Effect |
|---|---|
| An open, unsuppressed Error issue exists | The object is Bad (PI Points) or Error |
| Otherwise, an open, unsuppressed Warning issue exists | The object is Warning |
| Only Info issues, or none | The object is Good, unless it is Not Evaluated |
| An issue is suppressed | It no longer counts toward the object's health |
| An AF Attribute reads a PI Point | It shows the PI Point's health, unless the attribute itself is Error or Not Evaluated |
| An AF Element | Rolls up the health of its attributes and analyses |
Issue severities
| Severity | Changes health | Counted on the dashboard |
|---|---|---|
| Error | Yes | Errors |
| Warning | Yes | Warnings |
| Info | No | Info on the Issues page |
Issue states
| State | Meaning |
|---|---|
| Active | Open, with no suppression in force. An expired suppression makes the issue active again |
| Suppressed | Open, with a suppression in force. Left out of counts and percentages |
| Resolved | The latest check no longer found the problem. Resolved issues leave the Issues page |
An issue is identified by the object's stable identity (PointID, AF GUID) and the issue type, not by name or path. A renamed or moved object keeps its open issues.
Health percentages
Only active (not missing) objects are counted. Each percentage is Good divided by the denominator below.
| Type | Denominator |
|---|---|
| PI Points | All PI Points minus Warning and Not Evaluated. PI Points with Unknown quality count as not good |
| AF Attributes | All AF Attributes minus Not Evaluated and Unknown |
| AF Analyses | All AF Analyses minus Not Evaluated (disabled, stopped and not-ready analyses are Not Evaluated) |
| PI Vision | All displays minus Not Evaluated and unused displays. An unused display with a datasource error stays in |
| Overall Health | The average of the type percentages that have a value. PI Vision is left out when no PI Vision instance exists |
The same rule applies to the estate, a site, a server, an AF database and a PointSource.
| Rounding rule | Result |
|---|---|
| Denominator is 0 | No value (—) |
| All objects good | 100 % |
| Otherwise | Rounded to one decimal; a value that would round up to 100 is shown as 99.9 % |
Health bands
| Band | Percentage |
|---|---|
| Healthy | 90 % and above |
| Degraded | 80 % to below 90 % |
| Attention | Below 80 % |
| No data | No value. Emails show Unknown |
The bands colour the site tiles, the Health by type rows, the server cards and their rows, the Action View Health card, and the scan notification emails.
Suppression rules
| Item | Rule |
|---|---|
| Role | Operator |
| Scope | One object, issue code and issue value. Most issues have no value; some do, for example one calculation on a PI Vision display |
| Reason | Required |
| Expires | Optional. When it passes, the issue counts again |
| Restore | Ends the suppression. The issue counts again if the problem is still there; resolved issues keep the suppression as history |
| Suppress matching / Restore matching | Applies to every issue matching the current filters and site. Suppress matching never changes issues that are already suppressed |
| Batch size | Up to 1,000 matches run at once; 1,001 to 25,000 are queued (Queue Suppress, Queue Restore) and finish in the background; above 25,000 the action is refused until the filters are narrowed |
| Evaluation edition | Not available |
Acknowledging exists only for host issues; see Host Monitoring Reference.
