RTI Connext Modern C++ API Version 7.3.0
rti::core::MonitoringDedicatedParticipantSettings Class Reference

<<extension>> Configures the usage of a dedicated dds::domain::DomainParticipant to distribute the RTI Connext application telemetry data. More...

#include <rti/core/PolicySettings.hpp>

Public Member Functions

 MonitoringDedicatedParticipantSettings ()
 Creates an instance with the default settings. More...
 
MonitoringDedicatedParticipantSettingsenable (bool the_enable)
 Enables the use of a dedicated dds::domain::DomainParticipant to distribute the RTI Connext application telemetry data. More...
 
bool enable () const
 Getter (see setter with the same name). More...
 
MonitoringDedicatedParticipantSettingsdomain_id (int32_t the_domain_id)
 The domain ID used in the creation of RTI Monitoring Library 2.0 dds::domain::DomainParticipant. More...
 
int32_t domain_id () const
 Getter (see setter with the same name). More...
 
MonitoringDedicatedParticipantSettingsparticipant_qos_profile_name (const rti::core::optional_value< std::string > &the_participant_qos_profile_name)
 Sets the fully qualified name of the profile used to configure the dds::domain::DomainParticipant that will be used to distribute telemetry data. More...
 
MonitoringDedicatedParticipantSettingsparticipant_qos_profile_name (const char *the_participant_qos_profile_name)
 Sets the fully qualified name of the profile used to configure the dds::domain::DomainParticipant that will be used to distribute telemetry data. More...
 
rti::core::optional_value< std::string > participant_qos_profile_name () const
 Getter (see setter with the same name). More...
 
MonitoringDedicatedParticipantSettingscollector_initial_peers (const dds::core::StringSeq &the_collector_initial_peers)
 Determines the initial list of peers that the discovery process will contact to send announcements about the presence of the rti::core::MonitoringDistributionSettings::dedicated_participant. More...
 
dds::core::StringSeq collector_initial_peers () const
 Getter (see setter with the same name) More...
 

Detailed Description

<<extension>> Configures the usage of a dedicated dds::domain::DomainParticipant to distribute the RTI Connext application telemetry data.

Constructor & Destructor Documentation

◆ MonitoringDedicatedParticipantSettings()

rti::core::MonitoringDedicatedParticipantSettings::MonitoringDedicatedParticipantSettings ( )
inline

Creates an instance with the default settings.

Member Function Documentation

◆ enable() [1/2]

MonitoringDedicatedParticipantSettings & rti::core::MonitoringDedicatedParticipantSettings::enable ( bool  the_enable)

Enables the use of a dedicated dds::domain::DomainParticipant to distribute the RTI Connext application telemetry data.

Setting this value to false is not currently supported.

[default] true

◆ enable() [2/2]

bool rti::core::MonitoringDedicatedParticipantSettings::enable ( ) const

Getter (see setter with the same name).

◆ domain_id() [1/2]

MonitoringDedicatedParticipantSettings & rti::core::MonitoringDedicatedParticipantSettings::domain_id ( int32_t  the_domain_id)

The domain ID used in the creation of RTI Monitoring Library 2.0 dds::domain::DomainParticipant.

[default] 2

◆ domain_id() [2/2]

int32_t rti::core::MonitoringDedicatedParticipantSettings::domain_id ( ) const

Getter (see setter with the same name).

◆ participant_qos_profile_name() [1/3]

MonitoringDedicatedParticipantSettings & rti::core::MonitoringDedicatedParticipantSettings::participant_qos_profile_name ( const rti::core::optional_value< std::string > &  the_participant_qos_profile_name)

Sets the fully qualified name of the profile used to configure the dds::domain::DomainParticipant that will be used to distribute telemetry data.

Parameters
the_participant_qos_profile_nameAn optional string. An unset value indicates that the RTI Monitoring Library 2.0 uses rti::core::builtin_profiles::qos_lib::generic_monitoring2().

[default] Unset

If not set (the default value) then RTI Monitoring Library 2.0 uses rti::core::builtin_profiles::qos_lib::generic_monitoring2().

◆ participant_qos_profile_name() [2/3]

MonitoringDedicatedParticipantSettings & rti::core::MonitoringDedicatedParticipantSettings::participant_qos_profile_name ( const char *  the_participant_qos_profile_name)

Sets the fully qualified name of the profile used to configure the dds::domain::DomainParticipant that will be used to distribute telemetry data.

Parameters
the_participant_qos_profile_nameThe profile name. Cannot be NULL.

If not set (the default value) then RTI Monitoring Library 2.0 uses rti::core::builtin_profiles::qos_lib::generic_monitoring2().

◆ participant_qos_profile_name() [3/3]

rti::core::optional_value< std::string > rti::core::MonitoringDedicatedParticipantSettings::participant_qos_profile_name ( ) const

Getter (see setter with the same name).

◆ collector_initial_peers() [1/2]

MonitoringDedicatedParticipantSettings & rti::core::MonitoringDedicatedParticipantSettings::collector_initial_peers ( const dds::core::StringSeq the_collector_initial_peers)

Determines the initial list of peers that the discovery process will contact to send announcements about the presence of the rti::core::MonitoringDistributionSettings::dedicated_participant.

Parameters
the_collector_initial_peersThe initial peers.

These initial peers should correspond with the RTI Observability Collector Service with which RTI Monitoring Library 2.0 has to communicate. The collector_initial_peers works the same as initial_peers for other DomainParticipants, except that it allows you to easily specify the initial peer(s) for the RTI Monitoring Library 2.0 dds::domain::DomainParticipant, which usually has different initial peer(s) than those used by your application.

If no collector_initial_peers are specified, or if it is explicitly set to an empty list, the rti::core::policy::Discovery::initial_peers(const dds::core::StringSeq & the_initial_peers) list of rti::core::MonitoringDedicatedParticipantSettings::participant_qos_profile_name will be used as the initial peers of rti::core::MonitoringDistributionSettings::dedicated_participant.

[default] An empty sequence.

See also
rti::core::policy::Discovery::initial_peers(const dds::core::StringSeq & the_initial_peers) for further information about initial peers.

◆ collector_initial_peers() [2/2]

dds::core::StringSeq rti::core::MonitoringDedicatedParticipantSettings::collector_initial_peers ( ) const

Getter (see setter with the same name)