Skip to main content

Trace Lookup

Trace Lookup lets you find a specific distributed trace by its Trace ID. Use it when you already know which trace you want to inspect — for example, from a log line, an error report, or a correlation ID in an alert.

Trace Lookup

Getting Started​

Navigate to Traces → Lookup in the sidebar. The page displays a search bar where you can enter a Trace ID.

How to Use​

  1. Paste a Trace ID into the search field.
  2. Adjust the time range if needed — the time picker defaults to the last hour. Extend it if the trace occurred further in the past.
  3. Press Enter or click the search button.
  4. A trace summary bar appears showing the number of spans and overall duration.
  5. The trace detail view opens below, showing the full span waterfall, latency breakdown, and span attributes.

If the trace is not found, a "Trace Not Found" message is displayed. Try widening the time range.

Where to Find a Trace ID​

Trace IDs appear in many places throughout Oodle:

  • Log events — If your logs include a trace_id field, click it to jump directly to the trace.
  • Alerts — Alerts triggered by trace-based monitors often include the Trace ID.
  • Application code — Most tracing SDKs expose the Trace ID in error handlers and logging integrations.
  • Trace Explorer — Copy the Trace ID from the traces table for later reference.

Best Practices​

  • Widen the time range if the lookup returns no results. The trace may have occurred outside the default one-hour window.
  • Use Trace Lookup for debugging specific requests — When a user reports a slow request and provides a correlation ID, paste it here for instant access to the full trace.

Support​

If you have any questions or need assistance, please contact us via our help chat app available on the Support link in the sidebar, or by reaching out to support@oodle.ai.