How to monitor 3rd party data via RMS?

RMS monitoring templates allows users to utilize RutOS API inside the Teltonika devices to collect information from them, while Teltonika devices themselves can utilize various industrial protocols to collect data from 3rd party equipment. In other words, RMS can not directly get the information from 3rd party devices, but it can leverage Teltonika device's support of wide range industrial protocols to collect that information instead and just request that data from specific RutOS API endpoints.

M-Bus data monitoring

Device configuration

In this example we're using a temperature and humidity sensor that is connected to TRB143 and is sending that data via M-bus.

1. Add M-Bus device.
   
2. Input Primary address, and use Ping device to check connectivity with the M-bus device. If the ping is successful you can Save & Apply the new configuration. After this, the status should become Active.
   
3. Once M-Bus device is configured we need to set up Data collecting groups for the parameters we'd like to gather on RMS. In this example - it's the current temperature and current humidity values.
   Add a new Data collecting group.
   
4. In data collection group configuration add a new instance of M-Bus device from which the data will be collected.
   
5. A new window will open. Here we'll change Selected parameters from All to Custom and Load all available parameters. A list of parameters will be loaded, we'll choose humidity record first.
   
   
6. Now, let's name this new data collecting group to "humidity" and change data type to ASCII to get the value in plain text format.
   
   Click Test to see the response:
   
7. If you get the desired value, save the newly configured data collecting group by clicking on Save & Apply.
8. Then, let's repeat steps 3-7 for Temperature parameter.

RMS configuration | Monitoring template

1. In RMS go to Monitoring templates and add a new monitoring template for your device's API/Firmware version.
   
2. Now, let's navigate to Services -> M-Bus to view all API endpoints of M-Bus functionality.
   
3. We need to choose the exact endpoint of getting current (data collecting) group value. This endpoint is /mbus/groups/status/{id}.
   
4. However, it requires you to know the exact M-Bus group ID. You can view all group IDs by sending a Test endpoint request to /mbus/groups/config
   
5. After sending a test request, switch to Raw data to view the full array of configured M-bus data collecting groups. There, we can see our previously configured humidity and temperature data collecting groups allong with their IDs.
   
6. Let's get back to step 3 and input those IDs. You can input multiple instances by clicking on Add +.
   Once you input IDs, let's double-check if we receive the desired values by using Test endpoint.
   We can see that the desired response is received for the chosen ID. Let's include the parameter response to our monitoring template.
7. On the right side of monitoring template configuration, we can see our selected monitoring parameter.
   
   We can edit this monitored endpoint to change type from string to number as the value we're receiving is a number.
   
8. Once configured, let's save the monitoring template by clicking Save. A new window will open for the final touches, here, we'll need to input template name, change period from default if needed and assign devices to the monitoring template.
   

RMS configuration | Enabling monitoring template and viewing collected information

1. Now, we'll need to enable the monitoring template on the assigned devices. In Management -> Devices, in device table select those devices on which you assigned the template.
2. In actions menu, look for Manage monitoring templates and open it.
3. Enable our newly configured and assigned monitoring template and click Apply.
   
4. Now, if we go to this TRB143 Device details page -> Monitoring history and select our newly assigned and enabled monitoring template we'll see our Mbus data being collected. You may need to manually force update device information if the template was enabled just recently.
   

RMS configuration | Dashboard

1. In the same Device details page switch to Dashboards tab and create a new dashboard.
   
2. Input dashboard name, choose type (local - this device only, global - dashboard template available on all devices in your RMS company) and click Create.
   
3. A newly created dashboard template will appear, click on it to open it.
4. Now, we'll need to choose the preferred widget to display our data from M-Bus sensor being collected by utilizing custom monitoring templates. Click on + Add widget to open widget menu. We'll choose Charts group and specifically Line chart widget.
   
5. Now in Line chart configuration select monitoring template whose data will be visualized in this chart. In our case it's Mbus_sensor, and in Monitoring parameter(s) select your parameter from template and in our case, we additionally need to specify ID, one belongs to humidity another to temperature. By clicking on Preview, you will see chart preview on the left side.
   
6. Click Apply to save the widget.
7. After finishing configuring widgets, don't forget to Save the dashboard template.
   

In the chart we can see our M-Bus sensor's data visualized - ID 3 in my configuration corresponds to humidity, while ID 5 - temperature.