Cost Export

cost-tracking から session-* および budget-config-* レコードをすべて取得し、外部オブザーバビリティシステムが利用可能な形式で出力します。このスキルがない場合、コストデータは AgentDB 名前空間内にのみ存在しますが、このスキルを使用することで、同じデータがダッシュボードに反映されます。

使用するタイミング

• コスト追跡実行後、Grafana / Datadog / Prometheus のメトリクスを更新する場合。
• /loop 5m 経由でのクロンフレンドリーな実行により、外部ダッシュボードをほぼリアルタイムで保つ場合。
• 臨時レポーティング用に webhook に単発送信する場合(Slack、カスタムエンドポイント)。

ステップ

1. 形式を選択する — Prometheus / Grafana 用の textfile collector、またはその他すべて用の webhook POST:

   # Prometheus node_exporter textfile collector
   node plugins/ruflo-cost-tracker/scripts/export.mjs --prometheus /var/lib/node_exporter/textfile_collector/cost_tracker.prom
   
   # Webhook (JSON を POST; 環境変数で認証を追加)
   EXPORT_WEBHOOK_HEADER='Authorization: Bearer $TOKEN' \
     node plugins/ruflo-cost-tracker/scripts/export.mjs --webhook https://hooks.example.com/cost-tracker
   
   # stdout JSON (フラグがない場合のデフォルト)
   node plugins/ruflo-cost-tracker/scripts/export.mjs
   

2. 出力内容を確認する — Prometheus 出力には以下が含まれます:

   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>  (予算設定がある場合)
   cost_tracker_budget_utilization                           <gauge>  (消費額 / 予算)
   

3. Webhook ペイロード形式 — webhook が受け取る JSON は stdout JSON と一致します: { exportedAt, sessions: [...], budget, totalUsd, byTier }。ヘッダーは EXPORT_WEBHOOK_HEADER='K1: V1, K2: V2'(カンマ区切り)で追加できます。

環境変数オーバーライド

環境変数	デフォルト	目的
EXPORT_NAMESPACE	cost-tracking	対象名前空間をオーバーライド
EXPORT_WEBHOOK_HEADER	未設定	webhook 認証用のカンマ区切り K: V ペア
EXPORT_QUIET=1	未設定	エラー以外の確認出力を非表示

関連参照

• cost-track — このスキルがエクスポートするデータを生成
• cost-budget-check — 同じ cost_tracker_budget_* メトリクスは Prometheus でアラート可能
• node_exporter textfile collector ドキュメント(Prometheus 規約) — .prom ファイルを collector ディレクトリに配置すると、Prometheus が自動的に取得します