Diagnostics

1 Introduction to Diagnostics
2 Customizing Your View
- 2.1 Selecting Columns
- 2.2 Moving and Resizing Columns
3 Applying Filters
- 3.1 Filter Groups and Fields
- 3.2 Video: Applying Filters to the Diagnostics Table
4 Investigating Diagnostics
- 4.1 Diagnostic Report
- 4.2 Tasks
- 4.3 Equipment Profile
- 4.4 Video: Investigating Diagnostics

Introduction to Diagnostics

The Diagnostics module identifies and prioritizes performance issues across all equipment within the connected building portfolio. The table updates each day with the most recent findings impacting energy performance, comfort compliance, and equipment reliability. View the video below for a quick introduction on how to interact with the table.

Customizing Your View

The diagnostics table can be customized by selecting/removing which columns are displayed and resizing/reordering columns within the table.

Selecting Columns

Select the hamburger menu in the upper-right of the diagnostics table to “Select Columns” for display.

Column Name	Default Selection	Description

Column Name	Default Selection	Description
Organization	Unselected	Organization Name
Building	Selected	Building Name
Equipment	Selected	Equipment Name (e.g. AHU_01)
Equipment Class	Unselected	Equipment Class Name (e.g. Air Handler)
Analysis	Selected	Analysis Name (e.g. AHU Coils)
Latest Analysis Results	Selected	A preview of the identified performance issues from the latest analysis within the filtered date range
Cost	Selected	The sum of the avoidable cost over the filtered date range
Energy	Selected	The average of the Energy Priority over the filtered date range
Comfort	Selected	The average of the Comfort Priority over the filtered date range
Maint.	Selected	The average of the Maintenance Priority over the filtered date range
Average of ECM Priorities	Unselected	The average of all three priorities over the filtered date range
Max of ECM Priorities	Selected	A column chart displaying the maximum of the Energy, Comfort, or Maintenance priorities for each interval within the filtered date range
Ongoing Task	Selected	A count of the Open + In Process tasks for the Equipment/Analysis pair
Completed Task	Selected	A count of the Completed tasks for the Equipment/Analysis pair
Latest Update	Unselected	The date and time of the latest record (typically used when configuring diagnostics)
Configuration State	Unselected	The complete/incomplete state of the diagnostics configuration (typically used when configuring diagnostics)
Action	Selected	A drop-down menu with the following actions: Create Task View Raw Data Request Support

Moving and Resizing Columns

Click-and-drag the vertical border between header rows to resize the column. Drag-and-drop a column header to move the column. Click Save to retain the configuration of the table.

Applying Filters

Filter Groups and Fields

Filters are organized into four groups: Buildings, Equipment, Diagnostics, and Tasks. Within each filter group, selected filters will automatically limit the available options in subsequent filter selections (e.g. selecting the Equipment Class “Air Handler” will limit the available options within the “Equipment” filter to only those classified as Air Handlers).

Applied filters can be saved to retain the configuration of the Diagnostics table.

	Buildings Provider Organization Building Group Building Class Building Type Buildings
	Equipment Equipment Class Equipment Type Equipment
	Diagnostics Date Range (required) Analysis Interval (required) Analysis Name Priority Ranges (0-10) Avoidable Cost
	Tasks Date Created Date Completed Date Modified Task Status Task Assignee Task Reporter Annual Avoidable Cost

Video: Applying Filters to the Diagnostics Table

This video demonstrates how to use filters to:

View the top Comfort issues from the last 30 days
View the top AHU Coils and AHU Economizer issues by Avoidable Cost
View diagnostics with Ongoing Tasks (Open + In Process)

Investigating Diagnostics

Clicking any row within the table will launch a modal with three tabs:

Diagnostic Report

A summary at the top of the report details the analysis results and impacts for the diagnostic interval you are viewing. The column chart can be used to navigate to different intervals within your filtered date range.

A set of detailed notes is created for any analysis which identifies one or more faults or opportunities. The keyword “PROBLEM” is used for faults and “OPPORTUNITY” is used for energy efficiency opportunities. A brief description of the fault or opportunity is included, followed by either possible causes (for faults) or suggested actions (for opportunities). The section titled “Faults and Opportunities investigated by this diagnostic” at the end of the notes lists all checks that were successfully completed by the analysis, including checks which did not generate a fault or opportunity.

The Diagnostic Report also includes graphs supporting the notes. The graphs show data that is being referred to in the notes as well as other key operating parameters. Below are some basic things to keep in mind while reading the graphs:

Read the text and then look for the graphs that best illustrate the text. (For example, if the problem is with supply temperature not meeting setpoint, find the graph showing supply air temperature and setpoint. If the problem is with a leaking valve, find the graph showing the valve signals or temperatures before and after a coil.)
Read each graph axis so you know what units the data is in (for example, °F).
Read the legend below each graph and match the lines to the correct axis (if there is more than one axis).
Line graphs will be time series trends. Scatter plots will usually graph two nontemporal data points against each other (For example, the supply air temperature vs. outdoor air temperatures or chiller efficiency vs. part load fraction).
The timeline above the graphs represents the time over which the fault was occurring. A timeline that appears to be a solid color indicates that the fault was occurring during the entirety of the analysis period.

Tasks

The Tasks tab contains a list of all historical and ongoing tasks associated to the Equipment + Analysis pair you are viewing (e.g. AHU-3 + AHU Coils). Each row within the table can be clicked on to load the Task record for quick viewing and editing.

Equipment Profile

The Equipment Profile tab contains a summary of the configuration details for the selected equipment, including the static Equipment Variables and Building Variables used by the analysis. Each table can be expanded to see a detailed table of the variables/points.

Table Name	Description

Table Name	Description
Equipment Variables	A list of the assigned Equipment Variables which provide equipment ratings, sequence information, and other static information about the equipment.
Data Points	A list of the raw Data Points being collected from the Building Management System (BMS) and used in the Diagnostics.
Building Variables	A list of the assigned Building Variables which provide utility costs, CO2 equivalents, occupancy schedules, and other static information about the building.
Associated Equipment	A list of Associated Equipment for the selected system/equipment. Equipment associates are common for hydronic loops and complex Air Handlers. For example, a Chilled Water loop may have pumps and chillers listed as associated equipment.
Associated Equipment Variables	The Equipment Variables for the Associated Equipment.
Associated Equipment Points	The Data Points for the Associated Equipment.

Video: Investigating Diagnostics

This video provides a quick example of how to open the Diagnostic report and investigate the identified problems.