Distributed Tracing Version Compatibility
This section lists the releases of the PubSub+ event broker with the corresponding minimum and recommended OpenTelemetry Collector and PubSub+ Messaging API versions.
OpenTelemetry Receiver
The Solace Open Telemetry Receiver is part of the opentelemetry-collector-contrib repository. For details about releases of the collector from this repository, see https://github.com/open-telemetry/opentelemetry-collector-contrib/releases. To get a container package of the collector, run the following Docker command:
docker pull ghcr.io/open-telemetry/opentelemetry-collector-releases/opentelemetry-collector-contrib:<version>
Where <version> is the version of the collector, for example 0.79.0.
Solace recommends that you use the latest OpenTelemetry Collector version.
Version Compatibility
The following table lists the version compatibility of event broker versions, the supported PubSub+ Messaging APIs, PubSub+ OpenTelemtry API libraries, and OpenTelemetry Instrumentation libraries.
| PubSub+ Event Broker Version | OpenTelemetry Collector Minimum Version | Minimum Versions | ||
|---|---|---|---|---|
| PubSub+ Messaging API | PubSub+ OpenTelemetry API Library | OpenTelemetry Instrumentation Library | ||
|
10.2.0 |
0.63.1 |
N/A |
N/A |
N/A |
|
10.2.1 - 10.3.1 |
0.67 |
PubSub+ Messaging API for JCSMP: Version 10.17 |
PubSub+ OpenTelemetry Integration for Solace JCSMP API: Version 1.1 |
OpenTelemetry Instrumentation for Java: Version 1.29 |
|
PubSub+ Messaging API for JMS: Version 10.17 |
PubSub+ OpenTelemetry Integration for Solace JMS API: Version 1.1 |
OpenTelemetry Instrumentation for Java: Version 1.29 |
||
|
10.4.0 |
0.75 |
PubSub+ Messaging API for JCSMP: Version 10.17 |
PubSub+ OpenTelemetry Integration for Solace JCSMP API: Version 1.1 |
OpenTelemetry Instrumentation for Java: Version 1.29 |
|
PubSub+ Messaging API for JMS: Version 10.17 |
PubSub+ OpenTelemetry Integration for Solace JMS API: Version 1.1 |
OpenTelemetry Instrumentation for Java: Version 1.29 |
||
|
10.4.1 |
0.79 |
PubSub+ Messaging API for JCSMP: Version 10.17 |
PubSub+ OpenTelemetry Integration for Solace JCSMP API: Version 1.1 | OpenTelemetry Instrumentation for Java: Version 1.29 |
|
PubSub+ Messaging API for JMS: Version 10.17 |
PubSub+ OpenTelemetry Integration for Solace JMS API: Version 1.1 provides support for Spring 5.x and Spring Boot 2.x |
OpenTelemetry Instrumentation for Java: Version 1.29 |
||
| PubSub+ Messaging API for .NET: Version 10.21 | PubSub+ OpenTelemetry Integration for Solace .NET API: Version 1.0 | N/A | ||
|
10.5.1 or newer |
0.79 |
PubSub+ Messaging API for JCSMP: Version 10.17 |
PubSub+ OpenTelemetry Integration for Solace JCSMP API: Version 1.1 | OpenTelemetry Instrumentation for Java: Version 1.29 |
|
PubSub+ Messaging API for JMS: Version 10.17 |
PubSub+ OpenTelemetry Integration for Solace JMS API: Version 1.1 provides support for Spring 5.x and Spring Boot 2.x |
OpenTelemetry Instrumentation for Java: Version 1.29 |
||
| PubSub+ Messaging API for .NET: Version 10.21 | PubSub+ OpenTelemetry Integration for Solace .NET API: Version 1.0 | N/A | ||
| PubSub+ Messaging API for Javascript and PubSub+ Messaging API for Node.js: Version 10.15 | PubSub+ OpenTelemetry Integration for Solace JavaScript and Node.js APIs: Version 1.0 | N/A | ||
| PubSub+ Messaging API for Go: Version 1.5 | PubSub+ OpenTelemetry Integration for Solace Go API: Version 1.0 | N/A | ||
| PubSub+ Messaging API for Python: Version 1.7 | PubSub+ OpenTelemetry Integration for Solace Python API: Version 1.0 | N/A | ||
Only the PubSub+ Messaging API for JMS supports auto-instrumentation, all other PubSub+ Messaging APIs require manual instrumentation.
For auto-instrumentation, Solace recommends that you use the OpenTelemetry Instrumentation for Java library, version 1.29, which Solace has tested to work with PubSub+ products that support auto-instrumentation. Earlier versions of the library may not be compatible with PubSub+ products. For version details, see https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases.
- You must upgrade your OpenTelemetry Collectors to the minimum version listed above before you upgrade the PubSub+ event brokers that the Collectors are receiving OpenTelemetry data from.
- Version 10.2.0 of the PubSub+ event broker includes the initial implementation of the distributed tracing feature and requires versions of the OpenTelemetry Collector that include the Solace Open Telemetry Receiver.
- Version 10.2.1 of the PubSub+ event broker is the initial implementation of context propagation and is the minimum event broker release required to work with context propagation on any PubSub+ Messaging API.
To use context propagation, you must have the minimum required versions of the OpenTelemetry Collector as well as the minimum API release the Collector requires.
- Version 10.4.0 of the PubSub+ event broker is the initial implementation of partitioned queues.
If you want your trace messages to include the associated queue partition, you must have the minimum required versions of the OpenTelemetry Collector as well as the minimum API release the Collector requires.
- Version 10.4.1 of the PubSub+ event broker adds support for an egress span containing information on the transmission to and response from the consumer, including the outcome (ACK/NACK).