Splunk OpenTelemetry JS version 3.0 breaking changes 🔗
The Splunk OpenTelemetry JS version 3.0 contains a set of breaking changes. Previous versions (version 2.15.0 and prior) are compatible with these new changes. For more information about previous versions, see Instrument Node.js applications for Splunk Observability Cloud.
Update to Splunk OpenTelemetry JS version 3.0 🔗
To update your Splunk Distribution for OpenTelemetry JS agent to version 3.0, see Instrument your Node.js application for Splunk Observability Cloud and install the latest version of the Splunk OpenTelemetry JS agent.
Default port and protocol changes 🔗
In the Node.js 3.x instrumentation, the default protocol changed from gRPC to http/protobuf.
If a custom configuration overrides the default endpoint setting, you must make sure of the following:
Verify that the Node.js agent configuration is correct:
Verify that you are using the correct port for the selected protocol:
gRPC: 4317
http/protobuf: 4318
Verify that the custom endpoint configuration uses the correct port. For example:
OTEL_EXPORTER_OTLP_ENDPOINT=http://<host>:4318.Verify that the custom protocol configuration uses the correct protocol. For example:
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf.
In the OTel Collector configuration file, verify that the associated OTLP receiver protocols match those used by the Node.js agent. Here is an example OTLP receiver configuration in the OTel Collector file:
otlp: protocols: grpc: endpoint: "${SPLUNK_LISTEN_INTERFACE}:4317" http: endpoint: "${SPLUNK_LISTEN_INTERFACE}:4318"
Troubleshooting 🔗
If you are a Splunk Observability Cloud customer and are not able to see your data in Splunk Observability Cloud, you can get help in the following ways.
Available to Splunk Observability Cloud customers
Submit a case in the Splunk Support Portal .
Contact Splunk Support .
Available to prospective customers and free trial users
Ask a question and get answers through community support at Splunk Answers .
Join the Splunk #observability user group Slack channel to communicate with customers, partners, and Splunk employees worldwide. To join, see Chat groups in the Get Started with Splunk Community manual.