Calculate aggregated metrics and statistics across spans.

Use this tool to:

• Get latency percentiles for endpoints (p50, p95, p99)

• Calculate error rates by endpoint

• Get request counts over time

• Compare performance across environments

Examples:

• Endpoint latency: groupBy = ["name"], metrics = ["count", "avgDuration", "p95Duration"]

• Error rates: groupBy = ["name"], metrics = ["count", "errorCount", "errorRate"]

• Hourly trends: timeBucket = "hour", metrics = ["count", "errorRate"]

Get schema and structure information for span recordings on Tusk Drift.

Use this tool to:

• Understand what fields are available for a specific instrumentation type

• See example payloads for HTTP requests, database queries, etc.

• Learn what to filter on before querying spans

Common package names:

• http: Incoming HTTP requests (has statusCode, method, url, headers)

• fetch: Outgoing HTTP calls

• pg: PostgreSQL queries (has db.statement, db.name)

• grpc: gRPC calls

• express: Express.js middleware spans

Fetch specific span recordings by their IDs.

Use this tool when you have span IDs from a previous query and need the full details including payloads.

This is useful for:

• Getting full details for spans found via query_spans

• Examining specific requests in detail

• Comparing multiple specific spans

Get all spans in a distributed trace as a hierarchical tree.

Use this tool to:

• Debug a specific request end-to-end

• See the full call chain from HTTP request to database queries

• Understand timing and dependencies between spans

• Identify bottlenecks in a request

First use query_spans to find spans, then use the traceId to get the full trace.

List unique values for a field, ordered by frequency.

Use this tool to:

• Discover available endpoints (field: "name")

• See all instrumentation packages in use (field: "packageName")

• Find unique environments (field: "environment")

• Explore JSONB values like status codes (field: "outputValue.statusCode")

This helps you understand what values exist before building specific queries.

Search and filter API traffic span recordings.

Use this tool to:

• Find specific API calls by endpoint name, HTTP method, or status code

• Search for errors or slow requests

• Get recent traffic for a specific endpoint

• Debug specific API calls

Examples:

• Find failed requests: where = { fields: { "outputValue.statusCode": { gte: 400, access: { castAs: "int" } } } }

• Find slow requests: where = { fields: { duration: { gt: 1000 } } }

• Recent traffic for endpoint: where = { fields: { name: { eq: "/api/orders" } } }, limit = 10, orderBy = [{ field: "timestamp", direction: "DESC" }]