Aws/traces

Query and analyze X-Ray distributed traces for incident investigation and performance analysis.

Authentication

Uses the default AWS credential chain. Requires X-Ray permissions.

Required IAM Permissions

• xray:GetServiceGraph
• xray:GetTraceSummaries

Usage

# Create traces model
swamp model create @webframp/aws/traces aws-traces --global-arg region=us-east-1

# Get service dependency graph
swamp model method run aws-traces get_service_graph --input startTime=1h

# Get trace summaries
swamp model method run aws-traces get_traces --input startTime=1h

# Get traces with filter expression
swamp model method run aws-traces get_traces \
  --input startTime=1h \
  --input 'filterExpression=service("api") AND http.status = 500'

# Get error traces (convenience method)
swamp model method run aws-traces get_errors --input errorType=fault

# Analyze error patterns
swamp model method run aws-traces analyze_errors --input startTime=6h

Time Formats

The startTime and endTime parameters accept:

• Relative times: 30m, 1h, 2d (minutes, hours, days ago)
• ISO 8601 dates: 2026-03-30T12:00:00Z

Filter Expressions

X-Ray filter expressions support:

• service("name") - Filter by service name
• http.url - HTTP URL
• http.method - HTTP method (GET, POST, etc.)
• http.status - HTTP status code
• responsetime > 5 - Response time in seconds
• fault = true - Traces with faults (5xx)
• error = true - Traces with errors (4xx)
• throttle = true - Throttled requests

Methods

• get_service_graph - Get service dependency graph with health statistics
• get_traces - Get trace summaries with optional filter expression
• get_errors - Get error/fault traces (convenience method)
• analyze_errors - Analyze error patterns across traces