iobroker.history

Log state history in a two-stages process (first to RAM, then to disk)

Usage no npm install needed!

<script type="module">
  import iobrokerHistory from 'https://cdn.skypack.dev/iobroker.history';
</script>

README

Logo

ioBroker.history

Number of Installations Number of Installations NPM version

Test and Release Translation status Downloads

This adapter saves state history in a two-staged process.

This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers. For more details and for information how to disable the error reporting see Sentry-Plugin Documentation! Sentry reporting is used starting with js-controller 3.0.

Configuration

Changelog

1.11.0 (2022-02-22)

  • (bluefox) Added support deletion and changing of stored values.

1.10.6 (2022-02-19)

  • (Apollon77) Prevent some crash cases reported by Sentry

1.10.5 (2021-12-19)

  • (Excodibur) Hide settings not relevant when "log changes only" is not used
  • (Apollon77) Allow all number values for debounce again

1.10.4 (2021-12-14)

  • (bluefox) Support only js.controller >= 3.3.x
  • (bluefox) Used system/custom view for collecting the objects
  • (bluefox) Implemented option to ignore zero- or/and below zero- values

1.9.14 (2021-11-19)

  • (Apollon77) Prevent crash cases reported by Sentry

1.9.13 (2021-04-19)

  • (bluefox) Added the support of Admin5

1.9.12 (2021-01-17)

  • (Apollon77) Optimize stop handling

1.9.10 (2020-07-28)

  • (bluefox) Code formatting done
  • (bluefox) Filtered out the acknowledgment and the quality from the getHistory call if not requested

1.9.9 (2020-06-29)

  • (Apollon77) prevent crashes (Sentry IOBROKER-HISTORY-K, IOBROKER-HISTORY-J, IOBROKER-HISTORY-C, IOBROKER-HISTORY-G)

1.9.8 (2020-05-14)

  • (bluefox) added command to read supported features

1.9.7 (2020-05-08)

  • (bluefox) set default history if not yet set

1.9.6 (2020-05-04)

  • (Apollon77) optimize retention directory logic again (Sentry IOBROKER-HISTORY-A)

1.9.5 (2020-04-30)

  • (Apollon77) optimize retention directory logic again (Sentry IOBROKER-HISTORY-7)

1.9.4 (2020-04-23)

  • (Apollon77) Catch error when Storage directory can not be created (Sentry IOBROKER-HISTORY-1)
  • (Apollon77) make sure internal structures are initialized correctly (Sentry IOBROKER-HISTORY-2)
  • (Apollon77) make sure to handle cases where retention directory is not existing (Sentry IOBROKER-HISTORY-3)

1.9.3 (2020-04-19)

  • Requires js-controller >= 2.0.0
  • (foxriver76) removed usage of adapter.objects
  • (Apollon77) check if objects have changed and ignore unchanged
  • (Apollon77) adjust allowed file system names
  • (Apollon77) Add Sentry for Error Reporting with js-controller 3.0
  • (Apollon77) Make sure value undefined is ignored

1.8.7 (2019-09-02)

  • (paul53) old files should be deleted automatically

1.8.6

  • Fix several smaller issues and optimized some texts

1.8.5 (2018-07-02)

  • (Apollon77) Error fixed in storeState

1.8.4 (2018-06-24)

  • (Apollon77) Fixing/allow to disable writing of start and end values

1.8.0 (2018-06-19/24)

  • (Apollon77) Add option to write data to a different ID to make device changes easier. Retrieving data works for both IDs

1.7.4 (2018-04-03)

  • (AlCalzone) Fix filename handling for states with special characters

1.7.3 (2018-03-28)

  • (Apollon77) Respect 'keep forever' setting for retention from datapoint configuration

1.7.2 (2018-02-05)

  • (bondrogeen) Admin3 Fixes

1.7.1 (2018-01-31)

  • (Bluefox) Admin3 Fixes

1.7.0 (2018-01-17)

  • (bluefox) Ready for Admin3

1.6.6 (2017-12-20)

  • (bluefox) translations

1.6.5 (2017-10-05)

  • (Apollon77) fix relog value feature

1.6.4 (2017-08-12)

  • (bluefox) add "save last value" option

1.6.3 (2017-08-03)

  • (Apollon77) fix behaviour of log interval to always log the current value

1.6.2 (2017-04-07)

  • fix in datatype conversions

1.6.0 (2017-02-28)

  • (Apollon77) Replace some characters in history filenames

1.5.3 (2017-02-22)

  • (Apollon77) Small fix for older configurations

1.5.2

  • (Apollon77) Enhance Min-Delta logic for datapoints from type mixed

1.5.1 (2017-01-16)

  • (bluefox) Fix handling of float values in Adapter config and Datapoint config.

1.5.0 (2016-12-01)

  • (Apollon77) Add messages enableHistory/disableHistory
  • (Apollon77) add support to log changes only if value differs a minimum value for numbers
  • (Apollon77) Fixing aggregate calculation

1.4.0 (2016-10-29)

  • (Apollon77) add option to re-log unchanged values to make it easier for visualization
  • (Apollon77) added converter scripts to move history data to db

1.3.1 (2016-09-25)

  • (Apollon77) Fixed: ts is assigned as val
  • (bluefox) Fix selector for history objects

1.3.0 (2016-08-30)

  • (bluefox) —Āompatible only with new admin

1.2.0 (2016-08-27)

  • (bluefox) change name of object from history to custom

1.1.0 (2016-08-27)

  • (bluefox) fix aggregation of last point
  • (bluefox) aggregation none just deliver the raw data without any aggregation

1.0.5 (2016-07-24)

  • (bluefox) fix aggregation on large intervals

1.0.4 (2016-07-05)

  • (bluefox) fix aggregation on seconds

1.0.3 (2016-05-31)

  • (bluefox) draw line to the end if ignore null

1.0.2 (2016-05-29)

  • (bluefox) switch max and min with each other

1.0.1 (2016-05-28)

  • (bluefox) calculate end/start values for "on change" too

1.0.0 (2016-05-20)

  • (bluefox) change default aggregation name

0.4.1 (2016-05-14)

  • (bluefox) support sessionId

0.4.0 (2016-05-05)

  • (bluefox) use aggregation file from sql adapter
  • (bluefox) fix the values storage on exit
  • (bluefox) store all cached data every 5 minutes
  • (bluefox) support of ms

0.2.1 (2015-12-14)

  • (bluefox) add description of settings
  • (bluefox) place aggregate function into separate file to enable sharing with other adapters
  • (smiling-Jack) Add generate Demo data
  • (smiling-Jack) get history in own fork
  • (bluefox) add storeAck flag
  • (bluefox) mockup for onchange

0.2.0 (2015-11-15)

  • (Smiling_Jack) save and load in adapter and not in js-controller
  • (Smiling_Jack) aggregation of data points
  • (Smiling_Jack) support of storage path

0.1.3 (2015-02-19)

  • (bluefox) fix small error in history (Thanks on Dschaedl)
  • (bluefox) update admin page

0.1.2 (2015-01-20)

  • (bluefox) enable save&close button by config

0.1.1 (2015-01-10)

  • (bluefox) check if state was not deleted

0.1.0 (2015-01-02)

  • (bluefox) enable npm install

0.0.8 (2014-12-25)

  • (bluefox) support of de-bounce interval

0.0.7 (2014-11-01)

  • (bluefox) store every change and not only lc != ts

0.0.6 (2014-10-19)

  • (bluefox) add configuration page

License

The MIT License (MIT)

Copyright (c) 2014-2022 Bluefox dogafox@gmail.com, Apollon77

Copyright (c) 2016 Smiling_Jack

Copyright (c) 2014 hobbyquaker

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.