dd-symdb

Search Datadog Symbol Database to find probe-able methods for Live Debugger instrumentation.

5|2|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/lauhon/pi --skill dd-symdb-lauhon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dd-symdb
Source: https://github.com/lauhon/pi/tree/main/skills/dd-symdb
Command: npx skills add https://github.com/lauhon/pi --skill dd-symdb-lauhon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Locating the exact classes and methods where a live debugging probe can be placed in a running service is difficult without symbol information. This Skill queries the Datadog Symbol Database to list instrumented scopes and produce probe-ready method signatures. ## Core Features & Use Cases - Symbol Search: Search classes and methods in instrumented services by query, with optional version filtering. - Probe Location Output: Generate TYPE:METHOD(args) signatures directly usable with pup debugger probes create. - Multiple Views: Choose between raw JSON (full), one scope per line (names), or probe-ready signatures (probe-locations). - Use Case: You need to debug a production issue in VetController. Search the symbol database for probe-able methods, then place a Live Debugger probe on the discovered method and stream captured events. ## Quick Start Ask the assistant to search the Datadog Symbol Database for probe-able methods matching a class name in your service and then create a Live Debugger probe on the result.

Frequently Asked Questions about dd-symdb

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find probe-able methods in a Datadog instrumented service?

Run pup symdb search with the --service flag and a --query matching scope names, using --view probe-locations. The output returns TYPE:METHOD signatures that can be passed directly to pup debugger probes create.

How to search the Datadog Symbol Database with pup CLI?

Use pup symdb search --service <name> --query <term> after installing pup and authenticating. Add --view names, probe-locations, or full to control output format, and --version to filter by deployed service version.

What authentication does pup symdb search require?

Authentication uses OAuth2 via pup auth login, which is recommended, or API keys set through DD_API_KEY, DD_APP_KEY, and DD_SITE environment variables. Without valid credentials the search returns an auth error.

Why does symdb search return no results for my service?

Empty results usually mean the service is not instrumented or not reporting to Datadog. Verify the exact service name in the Datadog APM service catalog and confirm instrumentation is active.

Can I filter symbol search results by service version?

Yes, pass --version with a version string such as v1.2.3 to filter results. This targets the currently deployed version and avoids stale symbols from older deployments.