OpenParable
Skip to content
← Back to skills

Dd Symdb

Development
dd-symdb

Dd Symdb is an Agent Skill for development published in the DataDog/pup repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Symbol Database - search service symbols, find probe-able methods.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/DataDog/pup/blob/HEAD/skills/dd-symdb/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/dd-symdb, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Datadog Symbol Database

Search for classes and methods in instrumented services. Find probe-able method locations for use with the Live Debugger.

Prerequisites

pup must be installed:

brew tap datadog-labs/pack && brew install pup

Authentication

Authenticate via OAuth2 (recommended) or API keys:

# OAuth2 (recommended)
pup auth login

# Or use API keys
export DD_API_KEY="key" DD_APP_KEY="key" DD_SITE="datadoghq.com"

Usage

Names View

One scope name per line.

pup symdb search --service my-service --query "Controller" --view names

Probe Locations View

TYPE:METHOD(arg1, arg2, ...) signatures suitable for --probe-location in pup debugger probes create. Falls back to TYPE:METHOD when no argument info is available.

pup symdb search --service my-service --query "VetController" --view probe-locations

Full View

Raw JSON response from the API.

pup symdb search --service my-service --query "VetController" --view full

Filter by Version

pup symdb search --service my-service --query "handler" --version "v1.2.3" --view names

Combining with Debugger

Find methods then place probes:

# 1. Find probe-able methods
pup symdb search --service my-service --query "MyController" --view probe-locations

# 2. Place a probe on a discovered method (language auto-detected from symdb)
pup debugger probes create \
  --service my-service \
  --env production \
  --probe-location "com.example.MyController:handleRequest" \
  --template "handleRequest called with id={id}"

# Or use the full signature when multiple overloads exist
pup debugger probes create \
  --service my-service \
  --env production \
  --probe-location "com.example.MyController:handleRequest(int, java.lang.String)" \
  --template "handleRequest called with id={id}"

# 3. Stream events
pup debugger probes watch <PROBE_ID> --timeout 60 --limit 10

Options

FlagDescriptionDefault
--serviceService name (required)—
--querySearch query, matches scope namesNone (lists all)
--versionService version filterNone
--viewOutput view: full, names, probe-locationsfull

Failure Handling

ProblemFix
No resultsVerify the service is instrumented and reporting to Datadog
Auth errorRun pup auth login or set DD_API_KEY + DD_APP_KEY + DD_SITE
Wrong service nameCheck exact service name in Datadog APM service catalog
Stale symbolsFilter with --version to target the currently deployed version

References