Telemetry Configurations Settings

To configure the default telemetry data collection and enable the instrumentation of your application, you can modify the telemetry configuration settings in your TIBCO BusinessEvents application CDD.

For more details about the tracing in TIBCO BusinessEvents, see TIBCO BusinessEvents Application Tracing.

The following table lists the telemetry configuration settings available in the CDD editor of TIBCO BusinessEvents Studio.

Telemetry configurations
Property	Description
Service Name	A name to identify the application in telemetry data store. In the visualization software, you can identify your application using the Service Name. The default service name is `default`.
Sampler	(Optional) A sampler strategy helps control the volume of telemetry data that you want to export. `always_on` - Use this strategy to send every span to the export pipeline. `always_off` - Use this strategy to ensure that no spans are sent to the export pipeline. `traceidratio` - Use this strategy to send a specified fraction of spans based on their TraceId. You can specify the fraction value in the TraceId Ratio field. `parentbased_always_on` - When the request is coming from another application or service, use this strategy to use the sampling algorithm of the parent application or service, otherwise to send every span to the export pipeline. `parentbased_always_off` - When the request is coming from another application or service, use this strategy to use the sampling algorithm of the parent application or service, otherwise to not send any span to the export pipeline. `parentbased_traceidratio` - When the request is coming from another application or service, use this strategy to use the sampling algorithm of the parent application or service otherwise to send a specified fraction of spans based on their TraceId. You can specify the fraction value in the TraceId Ratio field. The default value is `always_on`.
TraceId Ratio	Enabled only when the `traceidratio` or `parentbased_traceidratio` sampler strategy is selected. A sampling ratio must be specified to a value between `0.0` to `1.0`. The `0.0` value specifies that no spans are to be send while the `1.0` value specifies that all spans are sent. For example, to send 50% of spans to the export pipeline, select the value as `0.5`. The default value is `1.0`.
Propagators	Enter a comma separated list of propagators to be used to serialize and deserialize the context. Click the Browse button to open the list of available propagators. You can select one or more than one propagators for your application. The following propagators are supported out-of-the-box in TIBCO BusinessEvents: `tracecontext` `baggage` `b3` `b3multi` `jaeger` `ottrace` The default propagator is `tracecontext`. For details about propagators, see OpenTelemetry documentation.
Disable Tracing Resource List	(Optional) Add resources here which you do not want to trace. You can use the full URI of rule, rule function, or destination, or partial paths to ignore all resources starting with that path. The list could also be updated through JMX at runtime. Note: If tracing is turned off for a destination, tracing is turned off for all rules and rule functions executed for that event. If a rule function is added to this list, the tracing data is not exported for the rule function and also for any catalog function invoked during execution.
Span Exporter	(Optional) Span exporter exports the telemetry data to the specified collector. The following options are provided as span exporter: `None` `OTLP` (OpenTelemetry collector) `Jaeger` `Zipkin` The default value is `None`.
Endpoint	The endpoint URL of the selected Span Exporter. This field is not displayed when the Span Exporter value is `None`.
Timeout	The request timeout (in milliseconds) for the selected Span Exporter. This field is not displayed when the Span Exporter value is `None`.
Headers	Provide comma-separated key-value pairs as headers with the equals to symbol = separating the key and value. This field is displayed when the Span Exporter value is `OTLP`.
Security Enabled	Select the check box to enable the secured connection. This field is displayed when the Span Exporter value is `OTLP`.
Security Certificate	Provide the path of the security certificate for the span exporter. This field is displayed when the Span Exporter value is `OTLP` and Security Enabled check box is selected.