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 OpenTelemetry 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
| 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 manual instrumentation only |
|
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 manual instrumentation only |
|
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 | ||
For auto-instrumentation, Solace recommends that you use the OpenTelemetry Instrumentation for Java library, version 1.29, which we have tested to work with PubSub+ products. Earlier versions of the library may not be compatible with the PubSub+ Messaging APIs. 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 from which the Collectors are receiving OpenTelemetry data.
- 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 OpenTelemetry 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).