--- title: MQTT Collector slug: changelog/mqtt-collector docTags: createdAt: 2025-12-23T08:32:18.150Z --- :::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 | MQTT Collector Version | Factry Historian Version | | --------------------- | ---------------------- | ------------------------ | | Measurement Discovery | >= v2.1.1 | >= v6.3.0 | | Collector Auto Update | >= v2.2.0 | >= v6.4.0 | | Windows 7, 8 support | \< 4.0.0 | / | | Measurement Metadata | >= v5.1.0 | >= v8.2.0 | ## v5.1.3 Released on 16/07/2026 ### Changes - Updated the base collector to v4.2.0 ## v5.1.2 Released on 12/06/2026 ### Changes - Updated the base collector to v4.1.2 ## v5.1.1 Released on 12/06/2026 ### Changes - Updated the base collector to v4.1.1 ## v5.1.0 Released on 11/04/2026 ### Changes - Updated the base collector to v4.1.0 ## v5.0.1 Released on 22/01/2026 ### Changes - Updated the base collector to v3.5.2 ## v5.0.0 Released on 20/11/2025 ### Changes - Migrated monitored/downsampled data collection to use the base collector implementation with noise filtering - Updated the base collector to v3.5.0 ## v4.1.1 Released on 22/08/2025 ### Bug fixes - Fixed updating a generic mqtt measurement's topic sometimes collecting data from both the old and new topic ## v4.1.0 Released on 20/06/2025 ### Changes - Added support for parsing quality of sparkplugB messages ## v4.0.1 Released on 23/05/2025 ### Changes - Updated the base collector to v3.1.1 - Added checks to avoid incorrect health updates ## v4.0.0 Released on 29/4/2025 - Updated the base collector to v3.1.0 - Removed support for windows 7, 8 - Improved async handling of MQTT messages - Changed the behavior of sending of rebirth messages for SparkplugB collector, and fixed the (re)discovery of paused measurements - Fixed a deadlock that could happen when subscribing to topics with the generic mqtt collector ## v3.0.1 Released on 29/01/2025 ### Changes - Disabled streaming until a data loss fix is implemented - Updated the base collector to v2.7.3 ## v3.0.0 Released on 08/01/2025 - Updated parsers to v4.0.2 - Added `HandleDataWithContext` function to the parser interface ## v2.5.4 Released on 02/01/2025 ### Changes - Updated base collector to v2.7.1 ## v2.5.3 ### Changes - Remove tag from custom parser ## v2.5.2 Released on 11/10/2024 ### Changes - Use message timestamp if no timestamp is present in the sparkplugB metric ## v2.5.1 Released on 07/10/2024 ### Changes - Made the sending of a rebirth message optional for SparkplugB ## v2.5.0 Released on 03/10/2024 ### Changes - Updated base collector to v2.6.0 ## v2.4.3 ### Bug fixes - Fixed crash when pausing a SparkplugB measurement - Make sure initial measurements are loaded before handling data in client ## v2.4.2 ### Bug fixes - Fixed initial connect not retrying on failure ## v2.4.1 ### Bug fixes - Improved performance of sparkplugB parser ### Changes - Added more settings related to the MQTT connection - Log incoming sparkplugB messages in trace mode ## v2.4.0 Released on 07/06/2024 ### Changes - Implemented downsampled data collection - Implemented monitored data collection - Added support for performance monitoring with Pyroscope ### Bug fixes - Restored windows 7 compatibility - Updated base collector to v2.4.8 ## v2.3.5 Released on 28/05/2024 ### Bug fixes - Fixed a bug where only one measurement was added per topic - Fixed a bug where collector type is registered incorrectly ## v2.3.4 Released on 23/05/2024 ### Changes - Updated base collector to v2.4.6 ## v2.3.3 Released on 21/05/2024 - Fixed typo in docs - Fixed a certain action blocking too long if a timeout happens ## v2.3.2 Released on 13/05/2024 - Fixed a possible deadlock when the collector was receiving an extremely high amount of messages ## v2.3.1 - Fixed a possible crash introduced in v2.3.0 ## v2.3.0 - Updated base collector to v2.4.5 - Added support for persistent sessions ## v2.2.2 ### Changes - Added IgnoreJSONPathErrors option to the Generic JSON parser. When set to true, the parser will ignore JSONPath errors for logging purposes. ## v2.2.1 ### Changes - Updated base collector to v2.4.3 ## v2.2.0 ### Changes - Added support for auto-updating. Requires historian server >= v6.4.0 - Updated base collector to v2.4.0 - Added support for SparkplugB array datatypes ## v2.1.2 ### Bug fixes - Generic JSON parser parses only data for relevant topic now ## v2.1.1 ### Changes - Ignore sparkplugB system metrics for auto discovery ## v2.1.0 ### Changes - Added functionality to auto onboard discovered measurements ## v2.0.0 ### Changes - Updated base collector to v2.2.0 - Added functionality to discover measurements for the SparkplugB parser ## v1.1.19 ### Changes - Added download for the MQTT Generic JSON Collector ## v1.1.18 ### Changes - Update documentation ## v1.1.17 ### Changes - Updated the base collector to v1.2.18 - Added Generic JSON parser that parses messages based on settable JSONPath paths. ## v1.1.16 ### Changes - Updated the base collector to v1.2.14 ### Bug fixes - Fixed measurements not being picked up after unpausing ## v1.1.15 ### Changes - Updated the base collector to v1.2.12 ## v1.1.14 ### Changes - Updated the base collector to v1.2.9 ## v1.1.13 ### Changes - Updated the base collector to v1.2.8 ## 1.1.12 ### Bug fixes - Fixed builds for incorrect architecture ## 1.1.11 ### Changes - Added docs/download to client portal - Made separate build for every MQTT parser ### Bug fixes - Trim tagnames whitespaces