Skills
.Work. You
Rest

trace-resource-request

Official

Trace resource requests end-to-end in Maestro.

Software Engineering#debugging#logs#trace#resource-id#op-id#Maestro#Kusto
Authoropenshift-online
Version1.0.0
Installs0

System Documentation

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>

Dependency Matrix

Required Modules

kubectl

Components

scriptsreferences

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: trace-resource-request
Download link: https://github.com/openshift-online/maestro/archive/main.zip#trace-resource-request

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.