otel-observability

Instrument federated squad agents with OpenTelemetry to collect traces, metrics, and logs.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/lygav/vladi-plugins-marketplace --skill otel-observability-lygav
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: otel-observability
Source: https://github.com/lygav/vladi-plugins-marketplace/tree/main/plugins/squad-federation-core/skills/otel-observability
Command: npx skills add https://github.com/lygav/vladi-plugins-marketplace --skill otel-observability-lygav

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Provide instrumentation guidance for federated squad agents using OpenTelemetry (OTel). The federation exposes four OTel tools via an MCP server. Each Copilot session gets its own MCP server instance that emits OTLP data to a shared collector. This creates unified observability across all parallel domain squads.

Core Features & Use Cases

  • Four OTel tools:
    • otel_span — Duration Tracking: Use spans to measure operation durations and carry attributes.
    • otel_metric — Counters and Gauges: Emit metrics at completion points (e.g., resources analyzed, lessons learned).
    • otel_event — Milestone Markers: Mark step transitions and external interactions.
    • otel_log — Decision and Debug Records: Capture human-readable decisions and debugging details.
  • Unified dashboard setup: Aspire dashboard integration with OTLP endpoints to visualize traces, metrics, and logs.
  • Domain-wide instrumentation patterns: Apply across domain squads and meta-squad sessions for consistent observability.

Quick Start

Run the dashboard setup to begin instrumenting your federated squad with OpenTelemetry and view traces in the Aspire observability dashboard.

Frequently Asked Questions about otel-observability

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

FAQPage Schema
How do I instrument agents with OpenTelemetry traces and metrics?

To instrument agents with OpenTelemetry traces and metrics, use the four OTel tools exposed via an MCP server. Each Copilot session gets its own server instance that emits OTLP data to a shared collector for unified observability across parallel domain squads.

What is the best way to track operation durations in federated squad agents?

The best way to track operation durations in federated squad agents is using the otel_span tool. It measures operation durations while carrying attributes, allowing you to capture detailed performance telemetry across distributed domain sessions and meta-squad contexts.

How do I set up an observability dashboard for OpenTelemetry data?

You set up an observability dashboard for OpenTelemetry data using the integrated Aspire dashboard. The dashboard workflow connects to OTLP endpoints to visualize traces, metrics, and logs, and is launched using provided start-up scripts for immediate real-time telemetry monitoring.

Can I capture human-readable decisions and debugging logs with OpenTelemetry?

Yes, you can capture human-readable decisions and debugging logs with OpenTelemetry using the otel_log tool. It records decision and debug details directly into your telemetry pipeline, feeding them into the unified Aspire observability dashboard alongside traces and metrics.

Does this OpenTelemetry instrumentation work across parallel domain squads?

Yes, this OpenTelemetry instrumentation works across parallel domain squads. It applies domain-wide instrumentation patterns to federated squad agents, ensuring each session emits OTLP data to a shared collector for consistent observability across all meta-squad contexts.

When do I need to emit metrics at completion points using OpenTelemetry?

You need to emit metrics at completion points using OpenTelemetry to track operational counters and gauges. The otel_metric tool records values like resources analyzed or lessons learned, providing quantitative telemetry for your federated squad agents upon step completion.