https://github.com/eprosima/fast-dds-spy
eProsima Fast DDS Spy is a CLI interactive tool that allows to introspect a DDS network in human readable format. Looking for commercial support? Contact info@eprosima.com
https://github.com/eprosima/fast-dds-spy
dds eprosima fastdds middleware ros2
Last synced: 7 months ago
JSON representation
eProsima Fast DDS Spy is a CLI interactive tool that allows to introspect a DDS network in human readable format. Looking for commercial support? Contact info@eprosima.com
- Host: GitHub
- URL: https://github.com/eprosima/fast-dds-spy
- Owner: eProsima
- License: apache-2.0
- Created: 2023-02-27T08:55:29.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2025-07-21T10:45:06.000Z (7 months ago)
- Last Synced: 2025-07-21T12:27:40.680Z (7 months ago)
- Topics: dds, eprosima, fastdds, middleware, ros2
- Language: C++
- Homepage: https://eprosima.com
- Size: 2.31 MB
- Stars: 13
- Watchers: 5
- Forks: 5
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://eprosima.com/middleware/tools/fast-dds-spy)
*eProsima Fast DDS Spy* is a CLI interactive tool that allows to introspect a DDS network in human readable format.
It is possible to query the network about the DomainParticipants connected, their endpoints (DataWriters and DataReaders) and the topics they communicate in.
It is also possible to see the user data sent through network topics in a schematic format in run time.
## Commercial support
Looking for commercial support? Write us to info@eprosima.com
Find more about us at [eProsima’s webpage](https://eprosima.com/).
## Documentation
You can access the documentation online hosted on *Read the Docs*.
* [Introduction](https://fast-dds-spy.readthedocs.io/en/latest/rst/formalia/titlepage.html)
* [Installation Manual](https://fast-dds-spy.readthedocs.io/en/latest/rst/installation/linux.html)
* [User Manual](https://fast-dds-spy.readthedocs.io/en/latest/rst/user_manual/usage_example.html)
* [Developer Manual](https://fast-dds-spy.readthedocs.io/en/latest/rst/developer_manual/installation/sources/linux.html)
* [Release Notes](https://fast-dds-spy.readthedocs.io/en/latest/rst/notes/notes.html)
## Installation Guide
The instructions for installing the *Fast DDS Spy* application from sources and its required dependencies on a Linux
environment are provided below. These installation instructions are a summarized version of the complete
[installation guide](https://fast-dds-spy.readthedocs.io/en/latest/rst/developer_manual/installation/sources/linux.html) available online. Instructions for installing *Fast DDS Spy* on a **Windows** platform can be found
[here](https://fast-dds-spy.readthedocs.io/en/latest/rst/developer_manual/installation/sources/windows.html).
### Requirements
*eProsima Fast DDS Spy* requires the following tools to be installed in the system:
* [CMake](https://cmake.org/), [g++](https://gcc.gnu.org/), [pip](https://pypi.org/project/pip/), [wget](https://www.gnu.org/software/wget/) and [git](https://git-scm.com/)
* [Colcon](https://colcon.readthedocs.io/en/released/) [optional, not required for CMake-only installation]
```bash
# apt packages
sudo apt install -y \
cmake \
g++ \
pip \
wget \
git \
libasio-dev \
libtinyxml2-dev \
libssl-dev \
libyaml-cpp-dev
# python packages
pip3 install -U \
colcon-common-extensions \
vcstool
```
### Colcon installation
1. Create a `Fast-DDS-spy` directory and download the `.repos` file that will be used to install *Fast DDS Spy* and its dependencies:
```bash
mkdir -p ~/Fast-DDS-spy/src
cd ~/Fast-DDS-spy
wget https://raw.githubusercontent.com/eProsima/Fast-DDS-spy/main/fastddsspy.repos
vcs import src < fastddsspy.repos
```
2. Build the packages:
```bash
colcon build --packages-up-to fastddsspy_tool
```
### Run an application
To run the *Fast DDS Spy* application, source the installation environment and execute the executable file that has been
installed in `/fastddsspy_tool/bin/fastddsspy`:
```bash
# Source installation
source /setup.bash
# Execute Fast DDS Spy
fastddsspy_tool
# Use to see the tool manual
```