Troubleshoot Ruby instrumentation for Splunk Observability Cloud π
When you instrument a Ruby application using the Splunk Distribution of OpenTelemetry Ruby and you donβt see your data in Splunk Observability Cloud, follow these troubleshooting steps.
Steps for troubleshooting Ruby OpenTelemetry issues π
The following steps can help you troubleshoot Ruby instrumentation issues:
Activate debug logging π
Debug logging increases the verbosity of the Ruby instrumentation. This can help you troubleshoot issues. To activate debug logging, set the OTEL_LOG_LEVEL
environment variable to debug
.
export OTEL_LOG_LEVEL="debug"
Make sure to unset the environment variable after the issue is resolved, as its output might overload systems if left on indefinitely.
Trace exporter issues π
By default, the Splunk Distribution of OpenTelemetry Ruby uses the OTLP exporter. Any issue affecting the export of traces produces an error in the debug logs.
OTLP canβt export spans π
To troubleshoot the lack of connectivity between the OTLP exporter and the OTel Collector, try the following:
Make sure that
OTEL_EXPORTER_OTLP_ENDPOINT
points to the correct OpenTelemetry Collector instance host.Check that your collector instance is configured and running. See Troubleshoot the Collector.
Check that the OTLP receiver is activated in the OTel Collector and plugged into the traces pipeline.
Check that the OTel Collector points to the following address:
http://<host>:4318
. Verify that your URL is correct.
401 error when sending spans π
If you send traces directly to Splunk Observability Cloud and receive a 401 error code, the authentication token specified in SPLUNK_ACCESS_TOKEN
is invalid. The following are possible reasons:
The value is null.
The value is not a well-formed token.
The token is not an access token that has
authScope
set to ingest.
Make sure that youβre using a valid Splunk access token when sending data directly to your Splunk platform instance. See Retrieve and manage user API access tokens using Splunk Observability Cloud.
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.