What is a Datasource?
A Datasource is a continuous stream of air quality measurements. It's connected to a source Device - a Clarity Node or a Reference Monitor - which feeds the measurements into the stream. Each Datasource is organized with Annotations - such as names, groups, and tags - to help identify and categorize the data. Accessing this data stream requires a Subscription.
Why are Datasources useful?
Datasources add a layer of flexibility to air quality monitoring by supporting:
- Device Replacement: You can preserve a continuous data stream from a site, even when devices are swapped out due to wear or malfunction. This ensures long-term monitoring data remains unified, regardless of device changes.
- Device Relocation: When you move a device to a new site, you can choose to either continue feeding data into the existing Datasource or start a new one. This allows you to keep data from different sites separate and organized.
Datasources page in details
Current Datasources
Current Datasources are Datasources that have a Node streaming measurements to them, and to which your organization has a valid Subscription.
You can view the number of Current Clarity Node Datasources, as well as Current Reference Station Datasources. Each row in the table holds the Datasource ID, its name/group/tags, its current source Device information, the expiration date for the Subscription granting your Organization access to its data, and its latest measurement for the parameter selected at the top of the page.
Previous Datasources
When a Datasource has no Device streaming measurements to it because it has been unconfigured, or the related Subscription is expired, it moves to the Previous Datasources table. This table acts as an archive of your historical data.
How do I manage my Datasources?
Datasources are managed indirectly, as a consequence of your Node management actions. Here's how to handle different scenarios:
-
Starting a New Datasource: Configuring a Node from your inventory automatically generates a new Datasource. It appears in the "Current Datasources" table, ready to stream data in real time.
- Archiving a Datasource: Unconfiguring a Node stops its associated Datasource. This Datasource then moves to the "Previous Datasources" table, where it keeps historical data available for future reference without active monitoring.
- Moving Monitoring to a New Site:
- Continuing with the Same Datasource: If you're relocating a Node but want to maintain the same Datasource, simply edit the Node's configuration. The data stream will continue without interruption in the "Current Datasources" table.
- Starting Fresh with a New Datasource: To create a new data stream for a different site, unconfigure the Node and then reconfigure it at the new location. The original Datasource moves to the "Previous Datasources" table, while a new Datasource begins in the "Current" table, ensuring clear separation of site data.
- Reference Monitor Datasources: Clarity Cloud automatically manages these. When a Reference Monitor near your Node becomes available, its Datasource is integrated into your organization, enhancing your data collection capabilities.
Datasource Actions
To perform an action, select a Datasource by clicking on a table row and click on the Blue Actions button. Most of the actions below can also be performed on a batch of Datasources. To do that, just select multiple Datasources in the table by clicking on the checkmarks.
About Datasource
Clicking on About Datasource navigates to a page where you can see everything there is to know about the datasource:
- Licensed indicates that you are the owner of the Subscription
- Shared indicates that another Organization is sharing the data with you
- If a Datasource is shared, you can see who is sharing the data or who you are sharing the data with
- Source of measurements indicates which Clarity Node or Reference Station is currently generating the measurements
- Open data reflects whether the data is visible on OpenMap
- Organization Admins who own the data subscription are able to make the Datasource visible on OpenMap
Datasource Measurements
Clicking on Datasource Measurements navigates to a page where you can visualize recent measurements and see some useful statistics.
Edit Name, Group, Tags
Clicking Edit Name, Group, Tags opens a modal that allows you to modify Datasource annotations. Keep annotations up to date to make it easier to search for Datasources across your organization
Note: please avoid naming Datasources the ID of the Clarity Node, as it will create confusion in case of Node replacement.
Clicking on Node Status opens the Status Details page for the Node currently streaming measurements to the Datasource. More info on the Status Details page can be found here.
Download Measurements
Clicking on Download Measurements allows you to download Datasource measurements as described here.