Always check the compatibility matrix below before installing a new version.

Compatibility

Collectors of all versions >= v1.0.0 are compatible with all Factry Historian versions >= v4.0.0, in both directions. However, for certain functionalities, certain minimum versions of the collector and Factry Historian are required.
More information is always available in the release notes.

Feature Compatibility Matrix

This is the compatibility matrix for version listed on this page. If you have downloaded a newer version than the one listed on this page please check the release notes of that version.

Feature Base Collector Version Factry Historian Version
State Saving >= v2.5.0 >= v7.0.0
GRPC Streaming (broken) >= v2.6.0 >= v7.1.0
OS, ARCH detection >= v2.8.0 /
Windows 7, 8 support < 3.0.0 /

v3.0.0

  • Removed support for windows 7 and 8
  • Changed handling of health updates to be separate from the logs

v2.8.1

  • Fixed polling of collector for updates getting stuck

v2.8.0

  • Added detection of the collector’s OS and ARCH to base collector, it no longer depends on GOOS and GOARCH environment variables since they not always contain the correct arm version.

v2.7.4

  • Improved handling of the collector state to make sure state changes from Factry Historian are not overwritten by the collector

v2.7.3

  • Disabled streaming

v2.7.2

  • Changed the permissions with which the systemd environment file is saved to 0600

v2.7.1

  • Fixed an issue with the cleanup of timers in High Availability mode

v2.7.0

  • Added new collector settings for a timestamp range filter
    • AllowedFutureDuration: Defines the maximum duration into the future from the current time (collector’s perspective) that a source timestamp is considered valid.
    • AllowedPast: Defines the earliest allowable point in time for source timestamps. This can be specified either as a fixed timestamp (e.g., 2023-07-01T00:00:00Z) or as a duration in the past relative to the current time (e.g., 1w for 1 week ago).
    • BadTimestampAction: Specifies the action to take when a timestamp is found to be outside the allowed ranges. Discard: the point is discarded. SendWithCurrent: the point is sent with the current timestamp and BadTimestampOutOfRange instead.

v2.6.1

  • Resolved an issue where collectors with migration functions would create empty settings during new installations.

v2.6.0

  • Separated the processing of item types in the buffer, allowing statistics and logs to be handled asynchronously when managing a backlog of points
  • Use streaming when sending data to the historian to lower the impact of high latency connections
  • Update the default GRPC compression to optimize for speed over compression

v2.5.2

  • Fixed an issue with semantic version comparison

v2.5.1

  • Properly close the collector when an upgrade is finished

v2.5.0

  • Added support for a collector saving it’s state to cache and in Historian. The state can be edited in the Historian UI.
  • Added support for migration hooks for the collector to run when the collector is upgraded.

v2.4.8

  • Fixed windows 7 compatibility issue
  • Fixed initial measurements getting zeroed prematurely

v2.4.6

  • Fixed base collector repeatedly sending measurements on the Added channel

v2.4.5

  • Changed when measurements are first loaded

v2.4.4

  • Fixed an issue with HA timer compatibility

v2.4.3

  • Free memory for garbage collection after taking items from the buffer
  • Added environment variable PPROF_PORT to run profiler if variable is set to a port number greater than 1024

v2.4.2

  • Made sure the collector binary is unique for each installed collector

v2.4.0

  • Expanded system statistics with: total disk space, total memory and free memory

v2.3.1

  • Improved logging during collector upgrade

v2.3.0

  • Added functionality for collectors to update themselves

v2.2.0

  • Added auto-onboarding of measurements

v2.1.1

Bug fixes

  • Fixed sending of collector statistics

v2.1.0

  • Added timestamp formatters to generalize the formatting of timestamps as strings

v2.0.0

  • Added functionality for discovering measurements
  • Removed Deleted channel. Deleted measurements are now sent on the Updated channel with status Deleted

v1.2.21

  • Minor bug fixes and improvements

v1.2.20

  • Minor bug fixes and improvements

v1.2.19

  • Added logging on add/update/delete of measurement

v1.2.18

  • Update historian-server to v6.0.5
  • Add Datatype to Measurements fetched from Historian

v1.2.17

  • Add timestamp parser to base collector

v1.2.16

Bug fixes

  • Fixed nil pointer exception in status processing

v1.2.15

Changes

  • Added StatusGood setting to accept other statuses as Good status

v1.2.14

Changes

  • Improved logging for failover collector
  • Better mac compatibility for debugging

v1.2.13

Changes

  • Starting the HTTP server for collector failover will retry periodically until the server is started

Changes

  • Add a check for Unstable health in collector redundancy

v1.2.11

Changes

  • Added a function to get the remaining memory buffer size

v1.2.10

Bug fixes

  • Fixed issue with loading the timezone data on windows

v1.2.9

Changes

  • Rename default collector binary name to factry-type-collector_version(.exe)

v1.2.8

Changes

  • Installer attempts to continue if installing binary returns an error

v1.2.7

Changes

  • Added release notes and docs for the base collector