Knowledge Base

The Analog Log stores analog values from the configuration, such as temperature, humidity, wind speed, energy consumption, or other numeric measurements.

Logged values can be displayed over different time intervals, allowing users to review trends, compare historical data, and monitor how values change over time.

Analog Logs are commonly used for environmental monitoring, energy reporting, weather data, and other values where historical tracking is useful.

Table of contents

Data Settings

Limit Database Writes limits writing to database. Within the specified interval (Write Interval) only one value is written to database. Write Type defines if this will be Average, Minimum or Maximum value of all values, received within the Write Interval.

If the boolean value is selected, true/false is converted to 0/1.

Maximum limit for database size can be set (Delete Old Data) in days (Days to Delete Old Data).

The Write Interval defines how often analog values are written to the log.

The interval is set in seconds. During each interval, bOS reads the values and then writes the selected result according to the Write Type setting.

For example, bOS can read multiple values during the interval and then store the average, minimum, maximum, or another selected value type, depending on the selected Write Type function.

This setting helps control how frequently data is stored and how detailed the historical log should be.

Write Type We can set to Average, Minimum and Maximum.

Delete Old Data we can enable and then function below it Days to Delete Old Recods is set it days. So if we set this value to 30 after 30 days, the first day of recording will be re-write with the latest value.

Scaling

If a device value or logged data is not displayed correctly, the Scale Data function can be used to adjust the value before it is stored or shown in the log.

bOS scales values using the following formula:

K × x + N

Where:

• x is the original input value

• K is used to multiply the input value

• N is used to add or subtract from the result

For example, if the value needs to be multiplied, adjust the K setting.
If a fixed value needs to be added or subtracted, adjust the N setting.

This is useful when values from a device need to be converted, corrected, or matched to the expected unit before being displayed in the Analog Log.

Data Backup

All Analog Log entries are displayed in the Data field at the bottom of the Analog Log settings.

This section can be used to check the recorded values and confirm that the log is storing data correctly.

Available data actions include:

• Refresh: Reloads the displayed log data.

• Clear: Removes the current data from the log.

• Export: Exports the log data as a table in .txt format. This is useful for reviewing, sharing, or processing the recorded values outside of bOS.

• Backup: Saves the log data and creates a .db backup file.

• Restore: Restores log data from a .db backup file. This can also be used to restore data from another compatible log.

These options make it possible to review, export, back up, and restore historical Analog Log data when needed.

Visualization settings

Analog Logs can be displayed in the bOS Client by dragging and dropping the log into the Theme.

After the log is added to the visualization, its appearance and behavior can be customized.

Available customization options include:

• Adding a title

• Setting X and Y axis labels

• Displaying units

• Changing the plot color

• Adding multiple plots to the same graph

• Adjusting units

• Changing background colors

• Displaying data by hours, days, weeks, or other time intervals

This allows users to create clear and customized graph views directly in the bOS Client app, making it easier to monitor trends, compare values, and review historical data from the building.

If we don’t want to add the whole graph, we can also select individual value from the log by simply selecting it when dragging the log into the visualization

To customize an existing plot in the visualization, double-click the log element in the Theme.

The plot can also be edited from the log settings in the Theme by opening the Collection function.

Data Logger

Data logger plot settings allow you to customize how values are displayed on the graph. Available options include:

• Changing the plot color

• Adding multiple plots to the same graph

• Selecting different value types, such as minimum, maximum, or average

• Enabling step plot display

• Filling the area under the plot

• Adjusting other visual and display settings

These options make it possible to create clearer and more detailed graph views for historical data in the bOS Client.

Analog Log in Visualization

Clicking a graph in the bOS Client opens a detailed view of the selected plot.

The bottom menu allows users to switch between different time ranges, including:

• Hour

• Day

• Week

• Month

• Year

• All

If the log contains multiple plots, all configured plots are displayed in the visualization.

Users can also swipe left or right to view the log data for a different time period.

The X axis displays time, while the Y axis displays the logged value at that time.

Graph Top Menu

The top menu provides additional tools for viewing, analyzing, and exporting log data. From left to right, the available options are:

• Snapshot: Creates a screenshot of the current graph view.

• Statistics: Opens graph statistics
  If the graph contains multiple logs, each log is downloaded as a separate file.

• Indicator: Turns the mouse cursor into a precise value indicator. Hovering over the graph displays the exact value at the selected point.

• Refresh: Refreshes the current log data.

• Close: Closes the graph view.

Statistics

Selecting the Statistics function on the top right, it will display all including data entries, values at each time point, minimum value, maximum value, and average value. Users can select the desired time frame and download the log data as a .db or .csv file. Under Data Entries, users can select between different logs if multiple logs are available in the graph.

To display a larger or more specific time period, use the Time Frame option on the right side of the statistics window. This allows users to select the starting and ending date for the displayed data.

Minimum and maximum values are also highlighted in the menu, making it easier to quickly identify the lowest and highest recorded values within the selected time frame.