trace-resource-request

Trace resource requests through the Maestro client-server-broker-agent pipeline using Kubernetes logs or Azure Kusto CSV exports.

20|48|Updated Nov 9, 2023
One-click install
npx skills add https://github.com/openshift-online/maestro --skill trace-resource-request
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trace-resource-request
Source: https://github.com/openshift-online/maestro/tree/main/.claude/skills/trace-resource-request
Command: npx skills add https://github.com/openshift-online/maestro --skill trace-resource-request

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires kubectl, and includes scripts (resource) and references (resource) components.

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>

Frequently Asked Questions about trace-resource-request

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I trace a resource request through the Maestro system end-to-end?

Tracing resource requests in Maestro involves running the trace script against your logs, specifying an operation ID, resource ID, work name, or manifest name to follow the request path from client through server, broker, and agent. The script scans Kubernetes logs or Azure Kusto CSV exports to locate all trace points and identify where failures occur.

Can I trace Maestro requests using Azure Kusto CSV exports instead of live Kubernetes logs?

Yes, the trace tool supports both live Kubernetes logs and Azure Kusto CSV exports from ARO HCP. This flexibility lets you analyze historical or exported data when direct cluster log access isn't available, using the same operation ID, resource ID, work name, or manifest name parameters.

What's the best way to debug where a resource request fails in the client-server-broker-agent pipeline?

End-to-end tracing identifies failure points by mapping the complete lifecycle of a resource request across all pipeline stages. The trace script auto-scans logs for key events, provides actionable next steps, and optionally performs deep-dive health checks on server and agent components to pinpoint the exact stage where failures occur.

Do I need kubectl installed to use the trace-resource-request Skill?

Yes, kubectl is a dependency for this Skill. It's required to access and analyze Kubernetes logs during the tracing process, though you can alternatively provide pre-exported Azure Kusto CSV files if direct cluster access isn't available.

How do I locate a specific resource request if I only have the work name or manifest name?

The trace script accepts work name or manifest name as lookup parameters alongside operation ID and resource ID. Run the script with `--work-name` or `--manifest-name` flags against your logs directory, and it will trace that request through the entire Maestro pipeline.