RTI Connext Modern C++ API Version 7.2.0
|
<<extension>> Configures event and periodic metrics collection and distribution for a specific set of observable resources. More...
#include <rti/core/PolicySettings.hpp>
Public Member Functions | |
MonitoringMetricSelection ()=default | |
Creates an instance with the default settings. More... | |
MonitoringMetricSelection & | resource_selection (const std::string &the_resource_selection) |
Sets an expression pattern used to match the resource names of observable resources to which the configured metrics through rti::core::MonitoringMetricSelection::enabled_metrics_selection and rti::core::MonitoringMetricSelection::disabled_metrics_selection apply. More... | |
std::string | resource_selection () const |
Getter (see setter with the same name). More... | |
MonitoringMetricSelection & | enabled_metrics_selection (const dds::core::StringSeq &the_enabled_metrics_selection) |
Sets A sequence of POSIX fnmatch patterns that match the names of the metrics that should be collected and distributed for the observable resources selected by rti::core::MonitoringMetricSelection::resource_selection. More... | |
dds::core::StringSeq | enabled_metrics_selection () const |
Getter (see setter with the same name) More... | |
MonitoringMetricSelection & | disabled_metrics_selection (const dds::core::StringSeq &the_disabled_metrics_selection) |
Sets A sequence of POSIX fnmatch patterns that match the names of the metrics that should not be collected and distributed for the observable resources selected by rti::core::MonitoringMetricSelection::resource_selection. More... | |
dds::core::StringSeq | disabled_metrics_selection () const |
Getter (see setter with the same name) More... | |
<<extension>> Configures event and periodic metrics collection and distribution for a specific set of observable resources.
[Not supported.]
|
default |
Creates an instance with the default settings.
MonitoringMetricSelection & rti::core::MonitoringMetricSelection::resource_selection | ( | const std::string & | the_resource_selection | ) |
Sets an expression pattern used to match the resource names of observable resources to which the configured metrics through rti::core::MonitoringMetricSelection::enabled_metrics_selection and rti::core::MonitoringMetricSelection::disabled_metrics_selection apply.
the_resource_selection | A string. |
Following there are some examples of resource expression patterns:
The first expression refers to a DomainParticipant named "myParticipant" that belongs to an application named "myApp". The second expression applies to all the Subscribers in the system (resource names wildcards follow the POSIX fnmatch syntax). The third expression refers to a DomainParticipant with a specific resource GUID in the "myApp" application. The last expression uses the XPath "//" operator. It matches observable resources named "myEntity" no matter where they are located in the resource hieararchy.
See the Telemetry Data / Resources chapter of RTI Connext Observability Framework documentation for further information on the observable resource names and expression patterns.
std::string rti::core::MonitoringMetricSelection::resource_selection | ( | ) | const |
Getter (see setter with the same name).
MonitoringMetricSelection & rti::core::MonitoringMetricSelection::enabled_metrics_selection | ( | const dds::core::StringSeq & | the_enabled_metrics_selection | ) |
Sets A sequence of POSIX fnmatch patterns that match the names of the metrics that should be collected and distributed for the observable resources selected by rti::core::MonitoringMetricSelection::resource_selection.
This sequence is evaluated first, followed by rti::core::MonitoringMetricSelection::disabled_metrics_selection. Therefore, if the same metric is enabled and disabled at the same time, the disablement will be the final result.
The patterns in the sequence are evaluated in order.
Some examples of valid patterns are:
The first pattern refers to a specific DataWriter metric (dds::core::policy::Durability::writer_depth). The second pattern refers to all the DataReader dds::core::policy::Reliability metrics. The last pattern selects all the available application metrics.
See the Telemetry Data / Metrics chapter of RTI Connext Observability Framework documentation for further information on the metric names and metric patterns. The metric names to which the patterns apply are the "Backend Independent Metric Names" listed in the same chapter.
dds::core::StringSeq rti::core::MonitoringMetricSelection::enabled_metrics_selection | ( | ) | const |
Getter (see setter with the same name)
MonitoringMetricSelection & rti::core::MonitoringMetricSelection::disabled_metrics_selection | ( | const dds::core::StringSeq & | the_disabled_metrics_selection | ) |
Sets A sequence of POSIX fnmatch patterns that match the names of the metrics that should not be collected and distributed for the observable resources selected by rti::core::MonitoringMetricSelection::resource_selection.
This sequence is evaluated after rti::core::MonitoringMetricSelection::enabled_metrics_selection. Therefore, if the same metric is enabled and disabled at the same time, the disablement will be the final result.
The patterns in the sequence are evaluated in order.
Some examples of valid patterns are:
The first pattern refers to a specific DataWriter metric (dds::core::policy::Durability::writer_depth). The second pattern refers to all the DataReader dds::core::policy::Reliability metrics. The last pattern selects all the available application metrics.
See the Telemetry Data / Metrics chapter of RTI Connext Observability Framework documentation for further information on the metric names and metric patterns. The metric names to which the patterns apply are the "Backend Independent Metric Names" listed in the same chapter.
dds::core::StringSeq rti::core::MonitoringMetricSelection::disabled_metrics_selection | ( | ) | const |
Getter (see setter with the same name)