3. Application Menu

This section describes the operations that can be performed in Fast DDS Monitor through the application menu.

3.1. File

3.1.1. Initialize Monitor

Button to start monitoring a new DDS network. The entities of this network will be automatically discovered. Moreover, their connections, their configuration and statistical data reported by them will be built and displayed on the monitor for further user queries.

Section Monitor Domain contains all the definitions and explanation about what monitor a domain means in the context of the application.

Pressing this button, a new Dialog with two tabs will be displayed. Each tab allows to start a monitor in a DDS network deployed using the Simple Discovery Protocol (SDP) or the Fast DDS Discovery Server (DS).

Warning

Starting a monitor in a domain or Discovery Server already initialize will duplicate the entities in them and may lead to an undefined behavior.

3.1.1.1. Simple Discovery

This dialog requests the user to introduce a number between 0 and 200 which will be the DDS Domain number. This will start a monitor in a specific DDS domain. The entities in this domain will be automatically discovered.

3.1.1.2. Discovery Server

This dialog requests the user to introduce a list of network addresses in a specific string format to connect with one or more Fast DDS Discovery Servers. This string must contain the IP-port pair where the Discovery Server is listening in the format ip:port separated by ;.

This will connect the Fast DDS Monitor to the Discovery Servers listening on the addresses set, and it will get all the discovery information of the entities connecting through them.

3.1.2. Export to CSV

Export all the data displayed in the current Fast DDS Monitor session to a CSV file. Please refer to section Export data for more information on the format of the generated CSV file.

3.1.3. Quit

Close the application.

3.2. Edit

3.2.1. Display Historical Data

Create a new historic Chartbox in the central panel. To know how to configure a historic Chartbox, please refer to the section Historic Data.

3.2.2. Display Dynamic Data

Create a new dynamic Chartbox in the central panel. To know how to configure a dynamic Chartbox, please refer to the section Real-Time Data.

3.2.3. Refresh

This button resets the entity clicked and the entities models in case there is some entity missing in the display.

3.2.4. Clear Log

This button clears the callbacks log.

3.2.5. Clear Issues

This button clears the issues log.

3.3. View

3.3.1. Hide/Show Inactive entities

The user of the application can decide whether to display the currently inactive entities. In case they are shown, it will be possible to access the data related to them, while if they are hidden from the monitor, they will no longer be available in the whole application framework. The latter means that it will not be possible to plot charts with data relating to these entities. This button hides/reveals the currently inactive entities detected by the monitor.

3.3.2. Hide/Show Metatraffic

Entities utilized for sharing metatraffic data are not shown by default. These include Fast-DDS Statistics module topics and the ones used by ROS for metatraffic data exchange, as well as the endpoints to which these topics are bound. Same as with the hide/show inactive entities feature, when metatraffic entities are hidden they are no longer available in the whole application framework. This button displays/hides the metatraffic entities detected by the monitor.

3.3.3. Dashboard Layout

Changes the size of the chart boxes displayed in the main panel of the application. Three mutually exclusive layout options are defined and explained below.

  • Dashboard Layout Large: A single full-screen chart is displayed.

  • Dashboard Layout Medium: Adjusts the chart size to show two chart boxes per row.

  • Dashboard Layout Small: Adjusts the chart size to show three chart boxes per row.

3.3.4. Hide/Show Shortcuts Toolbar

Hide the shortcuts superior toolbar if visible, or reveal it otherwise.

3.3.5. Customize Shortcuts Toolbar

Allow to show or hide independently the shortcut buttons in the shortcut toolbar.

3.3.6. Hide/Show Left sidebar

Hide the left sidebar if visible, or reveal it otherwise.

3.4. Help

3.4.1. Documentation

Link to this documentation.

3.4.2. Release Notes

Link to the Releases section of the GitHub Fast DDS Monitor repository.

3.4.3. Join Us on Twitter

Link to eProsima Twitter account.

3.4.4. Search Feature Requests

Link to the Issues section of the GitHub Fast DDS Monitor repository.

3.4.5. Report Issue

Link to the Issues section of the GitHub Fast DDS Monitor repository.

3.4.6. About

General information of the currently running Fast DDS Monitor application.