Skip to content

docs(telemetry): add search_sentry_tools recipe and result count pivots#1086

Merged
dcramer merged 1 commit into
mainfrom
docs/telemetry-search-tools-recipe
Jun 11, 2026
Merged

docs(telemetry): add search_sentry_tools recipe and result count pivots#1086
dcramer merged 1 commit into
mainfrom
docs/telemetry-search-tools-recipe

Conversation

@dcramer

@dcramer dcramer commented Jun 11, 2026

Copy link
Copy Markdown
Member

Add telemetry documentation for the search_sentry_tools catalog discovery pattern.

What's added:

  • Three new Investigation Pivots: mcp.tool.name, gen_ai.tool.call.result, gen_ai.tool.call.result.count
  • Query recipe for zero-result search_sentry_tools catalog calls (covers both the old search_tools name and the current search_sentry_tools name via OR)
  • Updated MCP Tool Execution domain to mention catalog discovery and the result count pattern
  • Attribute notes for all three new fields, including cardinality warnings on gen_ai.tool.call.result

Why: PR #1072 added gen_ai.tool.call.result and gen_ai.tool.call.result.count to search_sentry_tools spans but TELEMETRY.md wasn't updated. The mcp.tool.name field was also absent. Without this, zero-result queries are invisible in telemetry and there's no documented recipe for investigating tool catalog gaps.

Query syntax verified against production spans dataset.


View Session in Sentry

Co-Authored-By: sentry-junior[bot] <264270552+sentry-junior[bot]@users.noreply.github.com>
@dcramer dcramer marked this pull request as ready for review June 11, 2026 22:54
@dcramer dcramer merged commit 3fa5672 into main Jun 11, 2026
18 checks passed
@dcramer dcramer deleted the docs/telemetry-search-tools-recipe branch June 11, 2026 23:05
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.

1 participant