error-retry-tracking

Instrument error handling and retries with telemetry attributes and a reusable retry wrapper.

7|1|Updated Dec 26, 2025
One-click install
npx skills add https://github.com/nexus-labs-automation/agent-observability --skill error-retry-tracking
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: error-retry-tracking
Source: https://github.com/nexus-labs-automation/agent-observability/tree/main/skills/error-retry-tracking
Command: npx skills add https://github.com/nexus-labs-automation/agent-observability --skill error-retry-tracking

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Instrument error handling to understand failure patterns and recovery behavior across distributed components.

Core Features & Use Cases

  • Error Classification: categorize transient vs permanent failures to guide retries and fallbacks.
  • Retry & Fallback Telemetry: capture retry counts, delays, outcomes, and fallback transitions to optimize strategies.
  • Framework Integration: supports decorators and patterns (e.g., with_retry) to instrument LLM/tool calls and API requests.
  • Error Aggregation: summarize errors per session or provider to monitor health and regression.
  • Guardrails & Anti-patterns: detect common pitfalls and improve resilience with precautionary checks.

Quick Start

Wrap your callables with the with_retry decorator to start collecting retry telemetry and error context.

Frequently Asked Questions about error-retry-tracking

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

FAQPage Schema
How do I track error handling and retries to understand failure patterns in distributed systems?

Track error handling and retries by instrumenting telemetry attributes for failures, retry counts, and fallback transitions. This classifies transient versus permanent errors and summarizes recovery behavior per session or provider to monitor system health.

What is the best way to capture retry counts and fallback transitions for API integrations?

Capture retry counts and fallback transitions by wrapping API requests with a standardized retry wrapper like the with_retry decorator. This enforces consistent telemetry collection for retry delays, outcomes, and fallback shifts to optimize your integration strategies.

Can I use a retry wrapper to instrument LLM tool calls and observe recovery behavior?

Yes, you can instrument LLM tool calls by applying a reusable retry wrapper. This instruments the calls with telemetry spans that capture error context, retry attempts, and fallback outcomes, ensuring you can monitor latency and recovery behavior.

Why do I need error classification to guide retries and fallbacks in my observability setup?

Error classification separates transient failures from permanent ones, which is required to guide effective retries and fallbacks. Without categorizing failures, your retry strategy wastes resources on permanent errors and misses opportunities to recover from transient issues.

When should I not use a standardized retry wrapper for error tracking?

Avoid using a standardized retry wrapper when calls lack built-in fallback mechanisms or when blind retries exacerbate failure cascades in your distributed system. The telemetry relies on precautionary checks to detect anti-patterns, meaning uninstrumented calls bypass resilience guardrails.