Troubleshoot the OBI

If OBI does not collect expected telemetry, you can use several diagnostic tools and checks to identify common issues. OBI provides built-in troubleshooting features that help verify configuration, process discovery, and signal delivery.

For an overview of troubleshooting options, see the OpenTelemetry OBI troubleshooting guide.

Troubleshooting tools

OBI includes built-in tools that help validate whether processes are discovered, whether instrumentation is active, and whether telemetry is being generated and exported. These tools can help confirm that OBI is running correctly on the host or in a container.

You can also use external inspection tools such as WireShark to verify the network protocols used by your applications. This can help confirm whether the traffic you expect to monitor is supported by OBI.

For the full list of available troubleshooting tools, see troubleshooting tools reference.

Common issues

Some issues occur frequently when setting up or using OBI, such as missing telemetry, insufficient permissions, unsupported protocols, or configuration mismatches. Reviewing these known issues can help isolate the cause of unexpected behavior.

To review common issues and recommended fixes, see common OBI issues.