cost-export

devopsruvnet

Export cost-tracking telemetry in Prometheus textfile or webhook JSON formats — for external observability (Grafana, Datadog, custom dashboards)

Install

npx skills add https://github.com/ruvnet/ruflo --skill cost-export

SKILL.md

---name: cost-exportdescription: Export cost-tracking telemetry in Prometheus textfile or webhook JSON formats — for external observability (Grafana, Datadog, custom dashboards)argument-hint: [--prometheus <path>] [--webhook <url>]allowed-tools: Bash---

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

Pick a format — textfile collector for Prometheus / Grafana, or webhook POST for everything else:

# 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

Inspect what's emitted — Prometheus output includes:

cost_tracker_total_usd                                    <gauge>
cost_tracker_tier_total_usd{tier="opus|sonnet|haiku"}     <gauge>
cost_tracker_session_total_usd{session="<8-char>"}        <gauge>
cost_tracker_session_messages{session="<8-char>"}         <counter>
cost_tracker_budget_usd                                   <gauge>  (if budget configured)
cost_tracker_budget_utilization                           <gauge>  (spent / budget)

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

Related skills

azure-diagnosticsmicrosoft608KDebug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe triage. WHEN: debug production issues, troubleshoot app service, app service high CPU, app service deployment failure, troubleshoot container apps, troubleshoot functions, troubleshoot AKS, VM RDP, Linux SSH, VM black screen, can't connect to VM, reset VM password, NSG or firewall blocking, kubectl cannot connect, kube-system/CoreDNS failures, pod pending, crashloop, node not ready, upgrade failures, a azure-preparemicrosoft608KPrepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow. USE ONLY when the user explicitly wants to use azd as the deployment tool, or the project already has an azure.yaml file. DO NOT USE FOR: non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migration (use azure-cloud-migrate). WHEN: prepare app for azd, create azure.yaml, set up az azure-aimicrosoft608KUse for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.azure-deploymicrosoft607KExecute Azure deployments for ALREADY-PREPARED applications that have existing .azure/deployment-plan.md and infrastructure files. DO NOT use this skill when the user asks to CREATE a new application — use azure-prepare instead. This skill runs azd up, azd deploy, terraform apply, and az deployment commands with built-in error recovery. Requires .azure/deployment-plan.md from azure-prepare and validated status from azure-validate. WHEN: \"run azd up\", \"run azd deploy\", \"execute deployment\",