# Cost Export > Exporta la telemetría de cost-tracking en formato textfile de Prometheus o JSON vía webhook, para observabilidad externa (Grafana, Datadog, dashboards propios). Fuente: https://skillsagentes.com/skills/ruvnet/ruflo/cost-export Markdown: https://skillsagentes.com/skills/ruvnet/ruflo/cost-export.md Repositorio: https://github.com/ruvnet/ruflo Autor: ruvnet Licencia: MIT Actualizado: hace 3 meses Coste de contexto: 37 tok instalada, 691 tok al activarse, 691 tok con todos los archivos del bundle Bundle: 1 archivo, 3 KB Permisos que pide: 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 cost-export --agent claude-code # Cursor npx -y skills add ruvnet/ruflo --skill cost-export --agent cursor # Codex npx -y skills add ruvnet/ruflo --skill cost-export --agent codex # Gemini CLI npx -y skills add ruvnet/ruflo --skill cost-export --agent gemini # Windsurf npx -y skills add ruvnet/ruflo --skill cost-export --agent windsurf # Cline npx -y skills add ruvnet/ruflo --skill cost-export --agent cline ``` ## Qué hace - Extrae todos los registros `session-*` y `budget-config-*` de `cost-tracking` y los exporta en formato textfile de Prometheus o como JSON vía webhook. - Genera métricas como `cost_tracker_total_usd`, `cost_tracker_tier_total_usd`, `cost_tracker_budget_utilization`, listas para Grafana o Datadog. - Permite añadir cabeceras de autenticación al webhook mediante variable de entorno. ## Cuándo usarla - Después de cada ejecución de `cost-track`, para refrescar métricas en Grafana/Datadog/Prometheus. - Como tarea programada (`/loop 5m`) para mantener dashboards externos casi en tiempo real. - Para un reporte puntual vía webhook (Slack, endpoint personalizado). ## Qué la activa - "Exporta las métricas de costo a Prometheus" - "Envía un webhook con el resumen de gasto actual" ## Antes de instalar - Requiere que `cost-track` haya generado datos previamente en el namespace `cost-tracking`. - Variables de entorno: TOKEN - runs shell commands - makes network requests - needs API credentials ## Archivos - SKILL.md — 3 KB ## SKILL.md Reproducido tal cual desde ruvnet/ruflo bajo MIT. Esta sección es el documento original y está en inglés. # Cost Export Pulls every `session-*` and `budget-config-*` record from `cost-tracking` and emits in formats consumable by external observability systems. Without this, cost data lives only inside the AgentDB namespace; with it, the same data lights up dashboards. ## When to use - After any cost-track run, to refresh metrics for Grafana / Datadog / Prometheus. - Cron-friendly via `/loop 5m` to keep external dashboards near-real-time. - One-shot to a webhook for ad-hoc reporting (Slack, custom endpoint). ## Steps 1. **Pick a format** — textfile collector for Prometheus / Grafana, or webhook POST for everything else: ```bash # Prometheus node_exporter textfile collector node plugins/ruflo-cost-tracker/scripts/export.mjs --prometheus /var/lib/node_exporter/textfile_collector/cost_tracker.prom # Webhook (POSTs JSON; add auth via env) EXPORT_WEBHOOK_HEADER='Authorization: Bearer $TOKEN' \ node plugins/ruflo-cost-tracker/scripts/export.mjs --webhook https://hooks.example.com/cost-tracker # Stdout JSON (default if no flag) node plugins/ruflo-cost-tracker/scripts/export.mjs ``` 2. **Inspect what's emitted** — Prometheus output includes: ``` cost_tracker_total_usd cost_tracker_tier_total_usd{tier="opus|sonnet|haiku"} cost_tracker_session_total_usd{session="<8-char>"} cost_tracker_session_messages{session="<8-char>"} cost_tracker_budget_usd (if budget configured) cost_tracker_budget_utilization (spent / budget) ``` 3. **Webhook payload shape** — the JSON the webhook receives matches the stdout JSON: `{ exportedAt, sessions: [...], budget, totalUsd, byTier }`. Headers may be added via `EXPORT_WEBHOOK_HEADER='K1: V1, K2: V2'` (comma-separated). ## Env overrides | Env | Default | Purpose | |---|---|---| | `EXPORT_NAMESPACE` | `cost-tracking` | Override target namespace | | `EXPORT_WEBHOOK_HEADER` | unset | Comma-separated `K: V` pairs for webhook auth | | `EXPORT_QUIET=1` | unset | Suppress non-error confirmation output | ## Cross-references - `cost-track` — produces the data this skill exports - `cost-budget-check` — the same `cost_tracker_budget_*` metrics are alertable in Prometheus - node_exporter textfile collector docs (Prometheus convention) — drop the `.prom` file in the collector directory and Prometheus picks it up ## 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)