diff --git a/docs/How-to guides/How to create a dashboard.md b/docs/How-to guides/How to create a dashboard.md index 95bf289..6b9beb5 100644 --- a/docs/How-to guides/How to create a dashboard.md +++ b/docs/How-to guides/How to create a dashboard.md @@ -248,5 +248,5 @@ This would be an example of a device map panel: After creating one of these panels, you should select the dashboard for which you have created the panel, and you should see all the panels you have created for that dashboard. The panels vary depending on the type of panel and its configuration. - +d diff --git a/docs/How-to guides/How to create a schema.md b/docs/How-to guides/How to create a schema.md index 4c597b1..cce3205 100644 --- a/docs/How-to guides/How to create a schema.md +++ b/docs/How-to guides/How to create a schema.md @@ -70,6 +70,40 @@ Timestamp ones, the same as the rest with an extra one: ![Payload Timestamp](img/payload-timestamp.png) +### Data tranformation + +This would be a data transformation functionality during ingestion, which now includes advanced options such as the application of scaling and offsetting. This feature allows users to adjust their data more precisely during the ingestion process, this will be applicable to integers and decimals. + +How to Use the Functionality + +**Step 1: Access the Ingestion Configuration** +Navigate to the data ingestion module in the Biotz platform. +Select the "Data Transformation" option clicking where it says "fx": will only appear on click when having selected, integer, integer as text, integer as hexadecimal text, decimal and decimal as text. + +
+ ![Creating panels](img/click-to-tranform.png) +
+ +**Step 2: Define Transformation Rules with Scale and Offset** + +Click on "Tranformation type". +Select the type of transformation you want to apply, you can only choose scale and offset. +Configure the specific parameters of the transformation. + +For example: + +Scale: 1.5 +Offset: -2 +This means that each data value will be multiplied by 1.5 and then 2 will be subtracted. + +
+ ![Creating panels](img/transformation.png) +
+ +**Step 3: Apply Transformations** + +Associate the defined transformation rules with the data ingestion flow. + Once the schema is totally represented the ‘save’ button will register the schema. This will create the necessary machinery for the data validation and ingestion, it will also create the needed database structure for the data to be stored. ## Create a schema using the text editor diff --git a/docs/How-to guides/How to define alarm and triggers.md b/docs/How-to guides/How to define alarm and triggers.md index 05d7652..3bc30c4 100644 --- a/docs/How-to guides/How to define alarm and triggers.md +++ b/docs/How-to guides/How to define alarm and triggers.md @@ -21,12 +21,16 @@ The alarm trigger will apply to all the devices of a certain device type no matt The alarm triggers are defined in the “Alarm triggers” subsection under the “Setup” section.

-\ +
+ ![Creating panels](img/alarm-triggers.png) +
- +To create the first alarm click on the “New alarm trigger” button.If you want to create a new one you can also click on the top right hand corner.

-\ +
+ ![Creating panels](img/new-alarm-trigger.png) +
Defining an alarm requires three steps: general options, rule definition and notification settings. @@ -78,6 +82,8 @@ By default no users will be notified when an alarm is triggered. The triggered a

The selected users will get a web notification and an email when an alarm is triggered.

-\ +
+![Groups](img/select-user.png) +


To avoid overwhelming the user with notifications, a rate limit is applied to the notifications sent to the users. The users will be notified at most once every 15 minutes for each device an alarm trigger definition. Additional notifications will be ignored, but the alarm will be persisted and viewable in the alarms list. \ No newline at end of file diff --git a/docs/How-to guides/How to use dashboard variables.md b/docs/How-to guides/How to use dashboard variables.md index e22e0f0..24a207a 100644 --- a/docs/How-to guides/How to use dashboard variables.md +++ b/docs/How-to guides/How to use dashboard variables.md @@ -42,10 +42,16 @@ Once a dashboard variable is defined it can be used when defining dashboard pane For that, click on the “Variable, select a variable defined in the dashboard” in the query builder. Then select a specific variable from the list. Continue with the rest of the form as when selecting a specific device. +
+ ![Creating panels](img/variable-selector.png) +
+‍ The dashboard variable is now ready to use. Changing the device in the dashboard view will update the corresponding panels. +This is what a new panel would look like using variables: +
- ![Creating panels](img/variable-selector.png) + ![Creating panels](img/with-variables.png)
‍ diff --git a/docs/How-to guides/img/alarm-triggers.png b/docs/How-to guides/img/alarm-triggers.png new file mode 100644 index 0000000..dbb8593 Binary files /dev/null and b/docs/How-to guides/img/alarm-triggers.png differ diff --git a/docs/How-to guides/img/click-to-tranform.png b/docs/How-to guides/img/click-to-tranform.png new file mode 100644 index 0000000..554a709 Binary files /dev/null and b/docs/How-to guides/img/click-to-tranform.png differ diff --git a/docs/How-to guides/img/general-information.png b/docs/How-to guides/img/general-information.png new file mode 100644 index 0000000..ca79cb2 Binary files /dev/null and b/docs/How-to guides/img/general-information.png differ diff --git a/docs/How-to guides/img/new-alarm-trigger.png b/docs/How-to guides/img/new-alarm-trigger.png new file mode 100644 index 0000000..1de0648 Binary files /dev/null and b/docs/How-to guides/img/new-alarm-trigger.png differ diff --git a/docs/How-to guides/img/select-user.png b/docs/How-to guides/img/select-user.png new file mode 100644 index 0000000..6448605 Binary files /dev/null and b/docs/How-to guides/img/select-user.png differ diff --git a/docs/How-to guides/img/transformation.png b/docs/How-to guides/img/transformation.png new file mode 100644 index 0000000..c6e450d Binary files /dev/null and b/docs/How-to guides/img/transformation.png differ diff --git a/docs/How-to guides/img/with-variables.png b/docs/How-to guides/img/with-variables.png new file mode 100644 index 0000000..e9ab440 Binary files /dev/null and b/docs/How-to guides/img/with-variables.png differ