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. Dump¶
Dump the information from the database to a JSON file. Please refer to section Export data for more information on the format of the generated JSON file.
3.1.4. Dump and clear¶
Same as the previous one but clearing the statistics data of all the entities.
3.1.5. 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. Delete inactive entities¶
This button remove all the inactive entities from the database.
3.2.4. Delete statistics data¶
This button clear the statistics data of all the entities.
3.2.5. Scheduler Configuration¶
Creates a schedule to dump the database to a file, remove old data and/or remove inactive entities at a specified interval.
3.2.6. Refresh¶
This button resets the entity clicked and the entities models in case there is some entity missing in the display.
3.2.7. Clear Log¶
This button clears the callbacks log.
3.2.8. 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.
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.