OPC-UA Collector
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 | OPC-UA Collector version | Factry Historian Version |
|---|---|---|
Collector Auto Update | >= v1.6.0 | >= v6.4.0 |
v2.5.4
Released on 16/07/2026
Changes
- Updated the base collector to v4.2.0
Bug fixes
- Fixed several data races in connection state, node monitoring, and polling that could surface during reconnects and connection instability
- Hardened collector shutdown so polling goroutines are always awaited and no sends occur on closed channels
v2.5.3
Released on 19/06/2026
Bug fixes
- Skip unmonitoring of nodes call when no nodes are monitored
- Update the gopcua library with the most notable fix being: Reading or subscribing to large sets of nodes (roughly a thousand or more) over an encrypted connection no longer drops the connection with an EOF
v2.5.2
Released on 12/06/2026
Changes
v2.5.1
Released on 05/06/2026
Changes
- The FailedReadRequestsLimit setting can now be set to 0 to disable marking the collector as unstable after consecutive failed read requests
v2.5.0
Released on 11/05/2026
Changes
- Introduced the CollectionGroup setting to allow configuring multiple independent parallel groups of read requests
- The MaxReadRequests setting is now applied per collection group
v2.4.1
Released on 10/04/2026
Bug fixes
- Fixed a bug where the collector would not properly handle servers presenting certificate chains.
v2.4.0
Released on 19/03/2026
Changes
- OPC-UA date values are now supported. Measurements with the string datatype get RFC3339-formatted timestamps, number measurements receive the Unix timestamp in milliseconds.
- Bumped the upstream gopcua library to v0.8.0
v2.3.1
Released on 11/03/2026
Compatibility
- Make sure to upgrade Factry Historian to v8.0.7 or higher, it contains a fix for handling the migration of collector settings to properly handle splitting regular and secure settings
Bug fixes
- Fixed an issue in the migration hook for the ConnectEndpoint where it would run after every restart instead of only once
v2.3.0
Released on 05/03/2026
Changes
- Added ConnectEndpoint setting for more advanced connection setups
- Added Lifecycle setting for OPC-UA client lifecycle configuration
v2.2.1
Released on 22/01/2026
Changes
v2.2.0
Released on 24/11/2025
Changes
- Support for swinging door compression and noise filtering
v2.1.0
Released on 25/09/2025
Changes
- Added validation for collection interval and offset settings
- Trace log level will now enable low level OPC-UA debug logs
- Added group "Max nodes" to group some related advanced settings
v2.0.3
Released on 06/06/2025
Bug fixes
- Allow negative serial numbers in x509 certificates
v2.0.2
Released on 26/05/2025
Bug fixes
- Modified the measurement settings schema to make sure measurement creation cannot be blocked when not filling in EventFilterOperator
v2.0.1
Released on 23/05/2025
Changes
- Added checks to avoid incorrect health updates
v2.0.0
Released on 30/04/2025
Changes
- Removed support for windows 7 and 8
- Add support for filtering of events based on a field on the event
v1.9.3
Released on 29/01/2025
Changes
- Disabled streaming until a data loss fix is implemented
v1.9.2
Released on 02/01/2025
Changes
v1.9.1
Released on 09/10/2024
Changes
- Collector immediately goes into state ‘Unstable’ when the server closes the connection (collector receives EOF or writes to a broken pipe)
v1.9.0
Released on 03/10/2024
Changes
v1.8.1
Released on 06/09/2024
Bug fixes
v1.8.0
Released on 12/06/2024
Changes
- Unknown status codes now have the status code appended to the status message
- Added documentation about common OPC-UA status codes
v1.7.2
Released on 07/06/2024
Changes
- Added support for performance monitoring with Pyroscope
Bug fixes
- Restored windows 7 compatibility
v1.7.1
Released on 23/05/2024
Changes
v1.7.0
Released on 24/04/2024
Changes
- Added settings to be able to only collect one value from an array node based on the index
Bug fixes
- Fixed arm6 and arm7 builds
v1.6.3
Bug fixes
- Fixed a bug where the collector would get stuck reconnecting to the OPC-UA server
v1.6.2
Changes
v1.6.1
Bug fixes
- Fixed a bug where the collector would not pause a measurement
Changes
v1.6.0
Changes
- Added support for auto-updating. Requires historian server >= v6.4.0
v1.5.8
Changes
- send error points with BadFactryMonitorError when a monitor request fails
v1.5.7
Changes
- Disabled CGO
v1.5.6
Changes
v1.5.5
Changes
- Added a configurable failed read request limit counter
v1.5.4
Changes
v1.5.3
Changes
v1.5.2
Changes
Bug fixes
- Fixed a bug in the OPC-UA library causing the client to be stuck in an infinite loop
v1.5.1
Bug fixes
- Monitored measurement whose monitor request failed will periodically retry to monitor
- Added MonitorRetryTimeout advanced setting
v1.5.0
Changes
- Added the event collection type for OPC-UA Alarms & Conditions
v1.4.3
Bug fixes
- Fixed crash if buffer path could not be opened
- Collector no longer tries to register collector if historian API is unavailable
v1.4.2
Changes
- Added support for Idle state
- Removed warning, error, panic and fatal as possible log levels
v1.4.0
Changes
- Removed eventbuffer, this functionality has been moved to a separate collector
v1.3.6
Changes
- upgraded to gopcua library v0.3.5
v1.3.4
Bug fixes
- Restart collector on changed failover settings.
v1.3.0
When updating to this version keep in mind that environment variables that had a different value will need to be set in the Historian.
Changes
- Changed most environment variables to be configured as advanced collector settings in the Historian.
v1.2.1
Bug fixes
- Fixed panic on invalid node id
Changes
- Added timeout to cancel of OPC-UA subscription
- Fixed bug where collector might start polling twice when settings and status are changed within the collector polling window
v1.2.0
Changes
- Added preliminary support for redundancy
- The collector will not repeat logs regarding connection errors to the historian server
v1.1.8
Changes
- Added gzip compression for new buffer files, old buffer files will still work
- Added general environment variable, BUFFER_DISK_BATCHES, which determines how many batches will be written to a buffer file. Default value is 20
- Added priority for handling of buffer items, prioritizing logs and statistics over points Changed default value for BUFFER_MAX_BATCHES from 10 -> 100
- Points with value ‘Good’ now also get counted as good points in the statistics Added deploy trigger for OPC-UA documentation
v1.1.7
Bug fixes
- Fixed possible index out of range exception when getting system statistics
- Added measurement error status for unsupported values, FactryBadUnsupportedType
v1.1.6
Changes
- Changed ‘MaxAge’ property in OPC-UA requests from 2000 -> 0
- Added retries for NodeID registration
- Added possibility to disable registration of NodeID’s by setting
- MAX_NODES_PER_REGISTER to 0
v1.1.5
Changes
- Added first version of OPC-UA documentation
Bug fixes
- Fixed expired certificate problem
v1.1.4
Bug fixes
- Fixed crash on points with nil values
- Changed all points with nil values to 0
v1.1.3
Bug fixes
- Fixed potential out of bounds exception in buffer memory
- Fixed data race when calculating buffer size on disk
- Fixed handling of array values
v1.1.2
Changes
- Skip registration of integer node id’s
v1.1.1
Bug fixes
- Fixed last index of event buffer not getting processed
- Made quotes optional in event buffer node id’s
v1.1.0
Features
- Added event buffer functionality
Bug fixes
- Fixed OPC-UA client not connecting with some URL’s