You can connect Trendz Analytics to the ThingsBoard Community Edition or ThingsBoard Professional Edition.
By default, Trendz expects that ThingsBoard is hosted on the same instance and accessible via an URL:
If your ThingsBoard installation is hosted on another instance/port - you have to update config with correct value:
Open Trendz configuration file:
Windows: C:\Program Files (x86)\trendz\conf\trendz.yml
Linux: /usr/share/trandz/conf/trandz.yml
And update this property to the correct value:
tb.api.url: "${TB_API_URL:http://localhost:9090}"
For docker installations - update environment variable TB_API_URL
with the correct value.
Property | Environment Variable | Default Value | Description |
HTTP server parameters | |||
server.address | HTTP_BIND_ADDRESS | 0.0.0.0 | HTTP Server bind address |
server.port | HTTP_BIND_PORT | 8888 | HTTP Server bind port |
tb.api.url | TB_API_URL | http://localhost:9090 | ThingsBoard Cluster REST API url |
ratelimit.duration.sec | RATELIMIT_DURATION_SEC | 1 | Control amount of api calls per duration |
ratelimit.max_reqeusts_per_duration | RATELIMIT_MAX_REQUESTS | 5000 | Max number of allowed API calls per configured duration |
ratelimit.max_concurent_requests | RATELIMIT_CONCURRENT_REQUESTS | 8 | Max number of concurrent API calls. Overrides RATELIMIT_MAX_REQUESTS limit |
Trendz uses ThingsBoard as an authentication service. Any Tenant Administrator or Customer User can sign in into Trendz UI using their login\password that they use for authentication in the ThingsBoard.
Same security restrictions that are configured on the ThingsBoard works in the Trendz Analytics.
Trendz Topology represents the business model of Devices/Assets that was created in ThingsBoard. Topology defines dimensions/fields that used for building visualizations and relation between Devices/Assets. Here are the core components of Trendz Topology:
Business Entity - Definition of a group of Devices or Assets with same Device Type/Asset Type. Each Business Entity has:
After the first sign-in user should perform initial Topology Discovery. During this process, Trendz will analyze all Devices/Assets available in the ThingsBoard, their attributes/telemetry and all relations between them.
As a result, Trendz will extract and save the collection of Business Entities. You can view and modify them on the Settings
page.
Business Entity does not represent a single Device or Asset, but the query that used for fetching Device/Asset from the ThingsBoard. It means that you do not need to update topology if new Devices Assets with the same type were added on the ThingsBoard.
When new Device/Asset types were added or attribute/telemetry with a new key was created in the ThingsBoard - you should update Topology.
Manual Topology Rediscovery will scan ThingsBoard again, detect modifications and update collection of Business Entities with required settings.
You can trigger this process on the Settings
page by pressing Refresh Topology
.
Another option for updating topology is a manual modification of Business Entity properties. You can have as many Business Entities with similar properties as you want. It may be useful in case when the same devices/assets represent different aspects of business solution. For example, single devices can monitor the environment and submit debug events for troubleshooting. By separating debug events from environment measurements into isolated Business Entities it becomes easier to build visualizations focused on a single aspect of your solution.