DCH timeseries Onboarding Process

Before you continue, make sure you have read the Core Docs and have created the site and building you are onboarding. Also make sure you have created a data source and you have the username and password of that data source (unless you are onboarding without MQTT).

Current broker address is broker.dataclearinghouse.org. Legacy systems (setup prior to October 2024) used broker2.dataclearinghouse.org. Systems using broker2 should be updated when the opportunity arises.

If you would like to onboard your timeseries data using our REST API instead of MQTT, see our walkthrough here.

The main steps to be followed for the onboarding process are below and are described in more detail in the sections of this document:

Step	Requirement	How	Requires DCH Access
1	Check network will allow connection between the gateway and the DCH MQTT broker.	Configured by LAN administrator using site network management tools	No
2	Identify the DCH data source username and password that the site data will be associated with.	Provided in DCH under the data source page.	Yes
3	Setup the MQTT publish connection to DCH (host: broker.dataclearinghouse.org) and check connection.	Configured in the gateway.	No
4	Set up the MQTT topic under which the MQTT messages will be published.
5	Select the points in the gateway to be exported.
6	Configure the JSON messages with the required fields.
7	Check upload speed and queue sizes.
8	Initiate the upload.
9	Check the messages are arriving at the MQTT broker.	Configured via a PC.	No
10	Check that the datastreams in DCH are populating with data.	Data Source page in DCH	Yes
11	Check Gateway CPU usage because message queues can overload the processor.	Checked in the gateway.	No