Skip to content

Conversation

@kbatuigas
Copy link
Contributor

@kbatuigas kbatuigas commented Jan 27, 2026

Description

Resolves https://github.com/redpanda-data/documentation-private/issues/
Review deadline:

Page previews

https://deploy-preview-492--rp-cloud.netlify.app/redpanda-cloud/get-started/cloud-overview/

Checks

  • New feature
  • Content gap
  • Support Follow-up
  • Small fix (typos, links, copyedits, etc)

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Jan 27, 2026

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

  • 🔍 Trigger a full review
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch DOC-1901-document-feature-adp-execution-logs-ui-package-1

Important

Action Needed: IP Allowlist Update

If your organization protects your Git platform with IP whitelisting, please add the new CodeRabbit IP address to your allowlist:

  • 136.113.208.247/32 (new)
  • 34.170.211.100/32
  • 35.222.179.152/32

Failure to add the new IP will result in interrupted reviews.


Comment @coderabbitai help to get the list of available commands and usage tips.

:learning-objective-2: Navigate between detail views to inspect span information at different levels
:learning-objective-3: Use the timeline interactively to navigate to specific time periods

The Transcripts view provides filtering, searching, and navigation capabilities for investigating agent and MCP server execution transcripts. Use these features to efficiently locate specific operations, analyze performance patterns, and debug issues across tool invocations, LLM calls, and agent reasoning steps.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also anything that goes through the ai gateway should become visible through transcripts. Eventually also knowledgebase query operations - generally everything in the ADP that is being requested/queried should emit those traces/transcripts.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@weeco thanks, I'll hold off on specifying knowledge base for now

@c4milo anything we should say here regarding the gateway?


=== Use the interactive timeline

Use the timeline visualization to quickly identify when errors began or patterns changed, and navigate directly to transcripts from particular timestamps.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also: If we have many traces (e.g. hundreds or thousands) we can only show a subset of the traces. We have the timeline bar indicate what data is being shown currently. It may be just 5 minutes worth of data evne though you selected "Last 24h". Not sure if worth clarifying, should be intuitive hopefully

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added


=== Search and filter for transcripts

Use search and filters together to narrow down transcripts and quickly locate specific executions.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I need to clarify and follow-up what the search field and the filter targets. It's not clear at the moment. I'll try to have the search field compare against all span attributes in the selected time range (possibly exact matches only). Let's talk again by mid of next week, then I should have an answer for package 1

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@weeco got it, I'll check in shortly! Also, does it make sense to filter (instead of search) based on scope/layer? Would there be actual use cases for that


== Inspect span details

Each row in the transcript table represents a high-level agent or MCP server request flow. Expand each parent span to see the xref:ai-agents:observability/concepts.adoc#agent-transcript-hierarchy[hierarchical structure] of nested operations, including tool calls, LLM interactions, and internal processing steps. Parent-child spans show how operations relate: for example, an agent invocation (parent) triggers LLM calls and tool executions (children).
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Technically they will fold under the same trace. So for example if the declarative agent uses our remote mcp platform we will create a trace id on the very first touchpoint of the request and this trace id is passed around across services (such as the MCP server) and they will emit traces that belong to this trace id. That's why we can build this tree view for a single agent invocation.

If someone uses their own agents and just invokes the MCP servers directly on our platform then they may see a parent trace just for the MCP server invocation (unless they also pass around the trace id and emit traces from their agents to our platform)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated for detail

@paulohtb6 paulohtb6 mentioned this pull request Jan 29, 2026
4 tasks
@JakeSCahill
Copy link
Contributor

Worth having some content around using the new connectors to add your own traces or export them? 15292de

@kbatuigas kbatuigas changed the base branch from ai-agents-documentation to main January 30, 2026 17:49
@netlify
Copy link

netlify bot commented Feb 2, 2026

Deploy Preview for rp-cloud ready!

Name Link
🔨 Latest commit 81da213
🔍 Latest deploy log https://app.netlify.com/projects/rp-cloud/deploys/6982113ef76a990008a8d2a5
😎 Deploy Preview https://deploy-preview-492--rp-cloud.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@kbatuigas kbatuigas changed the base branch from main to adp-pkg1 February 3, 2026 00:32
@kbatuigas kbatuigas force-pushed the DOC-1901-document-feature-adp-execution-logs-ui-package-1 branch from b80bd5b to 9592dcb Compare February 3, 2026 00:33
@paulohtb6 paulohtb6 merged commit 74f55f2 into adp-pkg1 Feb 3, 2026
5 checks passed
@paulohtb6 paulohtb6 deleted the DOC-1901-document-feature-adp-execution-logs-ui-package-1 branch February 3, 2026 15:21
@paulohtb6
Copy link
Contributor

paulohtb6 commented Feb 3, 2026

GitHub closed the PR without me asking for it. Please consider this PR as WIP still.

@paulohtb6 paulohtb6 restored the DOC-1901-document-feature-adp-execution-logs-ui-package-1 branch February 3, 2026 15:33
@paulohtb6
Copy link
Contributor

replaced with #498

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants