--- title: OPC-UA Collector slug: changelog/opc-ua-collector docTags: createdAt: 2025-12-23T08:32:18.728Z --- :::hint{type="warning"} 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 - [Updated the base collector to v4.1.2](docId\:dJs1GFlKyD1m31dXQH5CU) ## 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 - [Updated the base collector to v4.1.0](docId\:dJs1GFlKyD1m31dXQH5CU) - 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 - [Updated the base collector to v4.0.3](docId\:dJs1GFlKyD1m31dXQH5CU) - 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 - [Updated the base collector to v4.0.0](docId\:dJs1GFlKyD1m31dXQH5CU) - 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 - [Updated the base collector to v3.5.2](docId\:dJs1GFlKyD1m31dXQH5CU) ## v2.2.0 Released on 24/11/2025 ### Changes - Support for swinging door compression and noise filtering - [Updated the base collector to v3.5.1](docId\:dJs1GFlKyD1m31dXQH5CU) ## 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 - [Updated the base collector to v3.3.1](docId\:dJs1GFlKyD1m31dXQH5CU) ## 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 - [Updated the base collector to v3.1.1](docId\:dJs1GFlKyD1m31dXQH5CU) - 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 - [Updated the base collector to v3.0.0](docId\:dJs1GFlKyD1m31dXQH5CU) ## v1.9.3 Released on 29/01/2025 ### Changes - Disabled streaming until a data loss fix is implemented - [Updated the base collector to v2.7.3](docId\:dJs1GFlKyD1m31dXQH5CU) ## v1.9.2 Released on 02/01/2025 ### Changes - [Updated base collector to v2.7.1](docId\:dJs1GFlKyD1m31dXQH5CU) ## 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 - [Updated base collector to v2.6.0](docId\:dJs1GFlKyD1m31dXQH5CU) ## v1.8.1 Released on 06/09/2024 ### Bug fixes - [Updated base collector to v2.5.1](docId\:dJs1GFlKyD1m31dXQH5CU) ## 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 - [Updated base collector to v2.4.8](docId\:dJs1GFlKyD1m31dXQH5CU) ## v1.7.1 Released on 23/05/2024 ### Changes - [Updated base collector to v2.4.6](docId\:dJs1GFlKyD1m31dXQH5CU) ## 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 - [Updated base collector to v2.4.3](docId\:dJs1GFlKyD1m31dXQH5CU) ## v1.6.1 ### Bug fixes - Fixed a bug where the collector would not pause a measurement ### Changes - [Updated base collector to v2.4.2](docId\:dJs1GFlKyD1m31dXQH5CU) ## v1.6.0 ### Changes - Added support for auto-updating. Requires historian server >= v6.4.0 - [Updated base collector to v2.4.0](docId\:dJs1GFlKyD1m31dXQH5CU) ## v1.5.8 ### Changes - send error points with `BadFactryMonitorError` when a monitor request fails ## v1.5.7 ### Changes - Disabled CGO ## v1.5.6 ### Changes - [Updated the base collector to v1.2.19](docId\:dJs1GFlKyD1m31dXQH5CU) ## v1.5.5 ### Changes - Added a configurable failed read request limit counter - [Updated the base collector to v1.2.12](docId\:dJs1GFlKyD1m31dXQH5CU) ## v1.5.4 ### Changes - [Updated the base collector to v1.2.9](docId\:dJs1GFlKyD1m31dXQH5CU) ## v1.5.3 ### Changes - [Updated the base collector to v1.2.8](docId\:dJs1GFlKyD1m31dXQH5CU) ## v1.5.2 ### Changes - [Updated the base collector to v1.2.7](docId\:dJs1GFlKyD1m31dXQH5CU) ### 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 :::hint{type="warning"} **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