What problem does it solve?
This skill helps engineers diagnose and debug the complete lifecycle of resource requests as they traverse the Maestro system, from client submission through the server, message broker, and Maestro agent back to clients and databases.
Core Features & Use Cases
- End-to-end tracing: Trace requests using operation IDs, resource IDs, work names, or manifest names across server, broker, and agent.
- Flexible data sources: Analyze live Kubernetes logs or Azure Kusto CSV exports from ARO HCP to locate trace points.
- Guided troubleshooting: Auto-scan logs for key events and provide actionable next steps, with optional deep-dive checks into server/agent health.
Quick Start
Run the trace script against your Maestro logs to locate the complete request path.
- Trace by operation ID:
bash .claude/skills/trace-resource-request/scripts/trace_request.sh --op-id <op-id> --logs-dir <path>
- Trace by resource ID:
bash .claude/skills/trace-resource-request/scripts/trace_request.sh --resource-id <resource-id> --logs-dir <path>
- Trace by work name:
bash .claude/skills/trace-resource-request/scripts/trace_request.sh --work-name <work-name> --logs-dir <path>
- Trace by manifest name:
bash .claude/skills/trace-resource-request/scripts/trace_request.sh --manifest-name <manifest-name> --logs-dir <path>