Release Notes

Version 1.0.0

This release includes the following API extensions:

• StatisticsBackend::get_status returns the entity status level of a given id.

• StatisticsBackend::get_info returns domain participant and endpoint app info.

• StatisticsBackend::get_domain_view_graph returns the domain view graph of a given domain.

• StatisticsBackend::regenerate_domain_graph regenerates the domain view graph of a given domain.

• StatisticsBackend::get_status_data returns an specific status data of a given id.

• Added status attribute for entities.

• Added database domain_view_graph map.

• Added monitor service topic status data storing and processing.

• Retrieve physical information from discovery packets.

• Physical related entities with an empty name are given the name Unknown by default.

This release includes the following dependencies update:

	Repository	Old Version	New Version
Foonathan Memory Vendor	eProsima/foonathan_memory_vendor	v1.3.1	v1.3.1
Fast CDR	eProsima/Fast-CDR	v1.1.0	v2.1.2
Fast DDS	eProsima/Fast-DDS	v2.11.0	v2.13.0
Fast DDS Gen	eProsima/Fast-DDS-Gen	v2.5.1	v3.0.0
IDL Parser	eProsima/IDL-Parser	v1.6.0	v1.7.2

Previous versions

Version 0.11.0

This release includes the following update:

• Regenerate TypeSupport with Fast DDS-Gen v2.5.1.

This release includes the following bugfix:

• Remove obsolete warning in documentation. Fast DDS v2.9.0 changed the default behavior by building with FASTDDS_STATISTICS enabled by default.

This release includes the following dependencies update:

	Repository	Old Version	New Version
Foonathan Memory Vendor	eProsima/foonathan_memory_vendor	v1.3.0	v1.3.1
Fast CDR	eProsima/Fast-CDR	v1.0.27	v1.1.0
Fast DDS	eProsima/Fast-DDS	v2.10.1	v2.11.0
Fast DDS Gen	eProsima/Fast-DDS-Gen	v2.4.0	v2.5.1
IDL Parser	eProsima/IDL-Parser	v1.5.0	v1.6.0

Version 0.10.0

This release includes the following feature:

• Extend method clear_statistics_data to remove internal statistical data previous to a time given.

Version 0.9.0

This release includes the following improvements:

1. Regenerate TypeSupport with Fast DDS-Gen v2.4.0.

This release includes the following bugfixes:

1. Fix documentation dependencies security vulnerabilities.

2. Install fixed gcovr version.

3. Fix build issues adding ignored Info statuses.

Version 0.8.0

This release includes the following features:

1. New API to clear statistic data and remove inactive entities from database.

This release includes the following improvements:

1. CI improvements:

   1. Include address-sanitizer job.

   2. Flaky tests are run in a specific job.

1. Internal implementation improvements:

   1. Remove database unused collections.

   2. Smart pointers refactor using unique instead of shared pointers.

1. Example:

   1. Improve example including new API.

This release includes the following bugfixes:

1. Memory leaks fixes reported by address-sanitizer.

Version 0.7.1

This release adds the following improvements:

• Update python dependencies for building the documentation

• Re-generate Fast DDS-Gen generated TypeSupport with Fast DDS-Gen v2.2.0

• Example to export ROS 2 statistics to Prometheus

Version 0.7.0

This release adds the following feature:

• Possibility of loading Fast DDS Statistics Backend’s DomainParticipant from Fast DDS XML configuration files.

This release adds the following improvements:

• Warn the user the Fast DDS Statistics module needs to be enabled.

• Update documentation regarding locator specification.

• Fix destruction error in the Database’s queue thread.

Version 0.6.0

This release adds the following improvement:

• Update statistics type support including physical data in DISCOVERY_TOPIC

Version 0.5.0

This release adds the following improvements:

• Improvements on Windows CI

• Refactor on processing queues to avoid data races with entity creation order

• Update Statistics Module type support

Version 0.4.0

This release has the following API extensions:

• StatisticsBackend::is_metatraffic allows the user to know if a specific topic or endpoint is related to metatraffic data.

This release adds the following features:

• Add HelloWorld Example.

This release includes the following bug fixes and improvements:

• Return the end of the time interval as the data point’s timestamps instead of the initial one.

• Avoid adding the same locator twice to the database.

• Fix deadlock when accessing the database within a callback implementation.

• Avoid using deprecated namespace.

• Improvements on CI.

Version 0.3.0

This release has the following API breaks:

• StatisticsBackend::dump_database methods now have an additional argument clear.

This release adds the following features:

• Dumping the database can optionally delete the traffic data from the internal data structures after the dump is completed, in order to reduce memory footprint.

• Support to create monitors on discovery server networks.

• Statistics data related to meta-traffic are now collected under the builtin meta-traffic endpoint created on each participant.

• Entities removed from the network now have a non-active status.

• Transitions between active and non-active status are notified to the user listeners.

• It is possible to change the domain listener and mask after the monitor is created.

This release includes the following bug fixes and improvements:

• By default, statistics data is received using UDP transport, shared memory is disabled.

• Network latency data now relates to a source participant and a destination locator (previously a source locator and a destination locator).

• Statistics data can now trigger the discovery of a new locator.

• Improved entity names and aliases to be more user friendly.

• Solved an issue that may cause the internal database to freeze.

• Allow for topics with the same name to be on different domains.

Version 0.2.0

This minor release is API compatible with the previous minor release, but introduces ABI breaks:

• Methods and attributes have been added on several classes, so indexes of symbols on dynamic libraries may have changed.

This release adds the following features:

• Support for Windows platforms

• Dumped data can now be loaded to the backend

• Backend can now be reset to a clean state (deleting all the data and monitors)

• StatisticsBackend::get_data implementation for SAMPLE_DATAS and DISCOVERY_TIME sample types

• StatisticsBackend::get_data implementation for zero bins

It also includes the following improvements:

• The participant info now contains all the locators of the participant

• Entities have an alias that can be set by the user to facilitate identification

Some important bugfixes are also included:

• Fixed errors when the same topic name is used on different domains

• Fixed crashes on database queues when database operation fails

Version 0.1.0

This first release includes the following features:

• Starting and stopping monitoring a DDS domain ID

• Keeping track of discovered entities (hosts, users, processes, participants, topics, data readers, data writers, and locators).

• Listening and recording statistics data related to the discovered entities, as reported by the Fast DDS statistics module.

• Retrieving the recorded statistics data, preprocessed with the requested statistic (mean, standard deviation, maximum, minimum, median)

• Persisting the recorded statistics to a file.

• Loading the statistics from a persisted file.