# Observe Trace

> Traza la ejecución de un agente recopilando spans y construyendo un árbol de traza para una tarea.

Fuente: https://skillsagentes.com/skills/ruvnet/ruflo/observe-trace
Markdown: https://skillsagentes.com/skills/ruvnet/ruflo/observe-trace.md

Repositorio: https://github.com/ruvnet/ruflo
Autor: ruvnet
Licencia: MIT
Actualizado: el mes pasado
Coste de contexto: 20 tok instalada, 522 tok al activarse, 522 tok con todos los archivos del bundle
Bundle: 1 archivo, 2 KB
Permisos que pide: mcp__plugin_ruflo-core_ruflo__memory_search mcp__plugin_ruflo-core_ruflo__memory_list mcp__plugin_ruflo-core_ruflo__agentdb_semantic-route mcp__plugin_ruflo-core_ruflo__agentdb_context-synthesize mcp__plugin_ruflo-core_ruflo__agentdb_pattern-search bash

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add ruvnet/ruflo --skill observe-trace --agent claude-code
# Cursor
npx -y skills add ruvnet/ruflo --skill observe-trace --agent cursor
# Codex
npx -y skills add ruvnet/ruflo --skill observe-trace --agent codex
# Gemini CLI
npx -y skills add ruvnet/ruflo --skill observe-trace --agent gemini
# Windsurf
npx -y skills add ruvnet/ruflo --skill observe-trace --agent windsurf
# Cline
npx -y skills add ruvnet/ruflo --skill observe-trace --agent cline
```

## Qué hace

- Recopila los spans de una tarea y los organiza en un árbol jerárquico padre-hijo.
- Calcula la duración de cada span e identifica el camino crítico.
- Marca cuellos de botella donde la duración supera el p95 o hay huecos de inactividad.
- Sintetiza los spans en un resumen narrativo del flujo de ejecución.

## Cuándo usarla

- Necesitas entender cómo se ejecutó una tarea entre varios agentes: qué spans corrieron, cuánto tardaron y dónde hubo cuellos de botella.

## Qué la activa

- "Traza la ejecución de la tarea TASK-123"
- "Muestra el árbol de traza y los cuellos de botella"

## Antes de instalar

- Necesita en el PATH: npx

## Archivos

- SKILL.md — 2 KB

## SKILL.md

Reproducido tal cual desde ruvnet/ruflo bajo MIT. Esta sección es el documento original y está en inglés.

# Observe Trace

Collect distributed trace spans for a task and build a visual trace tree showing the execution flow, timing, and bottlenecks.

## When to use

When you need to understand how a task was executed across agents -- which spans ran, how long each took, where bottlenecks occurred, and how agents coordinated.

## Steps

1. **Collect spans** -- call `mcp__plugin_ruflo-core_ruflo__memory_search --namespace observability` (or `memory_list`) to retrieve all spans matching the `<task-id>`. The `memory_*` tool family routes by namespace; `agentdb_hierarchical-*` does NOT (it routes by tier `working|episodic|semantic`), so use `memory_*` here. See [ruflo-agentdb ADR-0001 §"Namespace convention"](../../../ruflo-agentdb/docs/adrs/0001-agentdb-optimization.md).
2. **Build trace tree** -- organize spans into a parent-child hierarchy using `parentSpanId` references, with the root span at the top
3. **Calculate timing** -- for each span, compute duration (endTime - startTime), and identify the critical path (longest chain of sequential spans)
4. **Identify bottlenecks** -- flag spans where duration exceeds the p95 for that operation type, or where gaps between spans suggest idle time
5. **Synthesize** -- call `mcp__plugin_ruflo-core_ruflo__agentdb_context-synthesize` to combine span metadata into a narrative summary of the execution flow
6. **Report** -- display the trace tree with: span name, agent, duration, status (OK/ERROR), and bottleneck flag; include total trace duration and critical path duration

## CLI alternative

```bash
npx @claude-flow/cli@latest memory search --query "trace spans for task TASK_ID" --namespace observability
```

## Dónde encaja

- Categoría: [DevOps e infraestructura](https://skillsagentes.com/categorias/devops-infraestructura.md) — Despliegues, contenedores, IaC y flujos de gestión de incidentes.
- Creador: [ruvnet](https://skillsagentes.com/creators/ruvnet.md) — 275 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Harness Gepa](https://skillsagentes.com/skills/ruvnet/ruflo/harness-gepa.md): Inspecciona y audita genomas GEPA: carga y valida un genoma, renderiza el system prompt que compila, o clasifica los modos de fallo de una transcripción de ejecución.
- [Deepseek Reason](https://skillsagentes.com/skills/ruvnet/ruflo/deepseek-reason.md): Completion en modo razonamiento contra deepseek-reasoner (R1) de DeepSeek. Devuelve el chain-of-thought por separado de la respuesta final. Lee DEEPSEEK_API_KEY y degrada si falta o la API no responde.
- [Deepseek Chat](https://skillsagentes.com/skills/ruvnet/ruflo/deepseek-chat.md): Completion de un solo turno contra el modelo deepseek-chat de DeepSeek vía /v1/chat/completions. Lee DEEPSEEK_API_KEY y degrada con status:degraded si falta o la API no responde. Para tareas sin razonamiento.
- [Adr Index](https://skillsagentes.com/skills/ruvnet/ruflo/adr-index.md): Construye o reconstruye el índice de ADRs y su grafo de dependencias ejecutando scripts/import.mjs, en vez de cientos de llamadas MCP.
- [Agntcy Status](https://skillsagentes.com/skills/ruvnet/ruflo/agntcy-status.md): Muestra el estado de la integración AGNTCY/SLIM/CASA: si los paquetes están instalados, qué transporte está activo y si el enforcement de CASA está habilitado.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)