Hermes Agent: ダッシュボード

最終更新:2026-08-31

ダッシュボードはHermes Agentのコントロールパネルです。Token消費、コスト推移、ツール使用頻度、メモリ増加など、あらゆるデータが一目でわかります。

💡 ヒント: ダッシュボードにはCLIテキスト版とWebグラフィカル版の2つのインターフェースがあります。定期的にダッシュボードを確認することで、コスト最適化や異常検知に役立ちます。

📋 前提知識: 第4課 モデル設定、第10課 定期タスク

1. 学ぶ内容

# 内容
ダッシュボード機能概要
使用統計とコスト分析
パフォーマンス監視
ヘルスチェックとアラート
カスタムダッシュボード

2. ストーリー

(1) 課題:AIにいくら使ったか分からない

Bobは1ヶ月Hermesを使ったが、どれだけTokenを消費し、いくらかかったか把握していない。月末にAPI請求書が来て初めて驚く。

(2) 解決策:ダッシュボードでリアルタイム監視

Aliceは毎日ダッシュボードを確認:

BASH
hermes dashboard

# ┌─ Hermes Dashboard ─────────────────────┐
# │                                         │
# │ 💰 今月のコスト: $14.32 / 予算 $50     │
# │ 📊 Token消費: 3.2M / 10M              │
# │ ⏱️ 平均応答: 2.3s                      │
# │ 🔧 ツール呼び出し: 847回               │
# │ 📝 メモリエントリ: 156件               │
# │                                         │
# │ 📈 コスト推移 (7日間)                  │
# │ 3/9  ■■■■■■■□□□  $2.10                 │
# │ 3/10 ■■■■■■□□□□  $1.80                 │
# │ 3/11 ■■■■■■■■■□  $2.50                 │
# │ 3/12 ■■■■□□□□□□  $1.20                 │
# │ 3/13 ■■■■■■■■□□  $2.30                 │
# │ 3/14 ■■■■■■■■■■  $2.80                 │
# │ 3/15 ■■■■■■□□□□  $1.62 (本日現在)     │
# └─────────────────────────────────────────┘

3. ダッシュボード機能概要

(1) コア指標

指標 説明 単位
月間コスト API呼び出し総費用 USD
Token消費 入力+出力Token 百万
平均応答時間 LLM推論レイテンシ
ツール呼び出し回数 各ツールの使用頻度
メモリエントリ 長期メモリの数
スキル使用 各スキルの呼び出し回数

(2) アクセス方法

BASH
# CLIテキスト版
hermes dashboard

# Webグラフィカル版
hermes dashboard --web --port 3000
# ブラウザでhttp://localhost:3000を開く

# 個別指標の確認
hermes stats cost
hermes stats tokens
hermes stats tools

4. 使用統計とコスト分析

(1) コストレポート

BASH
hermes cost report --month

# 出力:
# ┌──────────────┬──────────┬───────────┬───────────┬─────────┐
# │ Model        │ Requests │ Tokens In │ Tokens Out│ Cost    │
# ├──────────────┼──────────┼───────────┼───────────┼─────────┤
# │ gpt-4o-mini  │ 1,200    │ 2.4M      │ 0.8M      │ $2.16   │
# │ gpt-4o       │ 80       │ 0.8M      │ 0.4M      │ $6.00   │
# │ claude-3.5   │ 40       │ 0.6M      │ 0.3M      │ $5.70   │
# │ llama3.2     │ 500      │ 1.0M      │ 0.5M      │ $0.00   │
# ├──────────────┼──────────┼───────────┼───────────┼─────────┤
# │ Total        │ 1,820    │ 4.8M      │ 2.0M      │ $13.86  │
# └──────────────┴──────────┴───────────┴───────────┴─────────┘

(2) タスクタイプ別分析

BASH
hermes cost report --by-task

# 出力:
# ┌──────────────┬──────────┬─────────┬────────────┐
# │ Task Type    │ Requests │ Cost    │ % of Total │
# ├──────────────┼──────────┼─────────┼────────────┤
# │ code_review  │ 120      │ $4.50   │ 32%        │
# │ web_search   │ 340      │ $2.80   │ 20%        │
# │ chat         │ 800      │ $3.20   │ 23%        │
# │ translation  │ 200      │ $1.86   │ 13%        │
# │ cron_tasks   │ 360      │ $1.50   │ 11%        │
# └──────────────┴──────────┴─────────┴────────────┘

(3) コスト予算

YAML
# 月間予算の設定
dashboard:
  budget:
    monthly_limit: 50          # 月予算50 USD
    warning_threshold: 0.8     # 80%で警告
    daily_limit: 5             # 日予算5 USD
    
  alerts:
    - type: "cost_threshold"
      threshold: 40            # 40 USDでアラート
      notify: "telegram"
      
    - type: "daily_exceed"
      notify: "telegram"

5. パフォーマンス監視

(1) 応答時間

BASH
hermes stats latency

# 出力:
# ┌──────────────┬─────────┬─────────┬─────────┐
# │ Model        │ Avg (s) │ P50 (s) │ P99 (s) │
# ├──────────────┼─────────┼─────────┼─────────┤
# │ gpt-4o-mini  │ 1.2     │ 1.0     │ 3.5     │
# │ gpt-4o       │ 2.8     │ 2.5     │ 6.2     │
# │ claude-3.5   │ 3.1     │ 2.8     │ 7.0     │
# │ llama3.2     │ 4.5     │ 4.0     │ 12.0    │
# └──────────────┴─────────┴─────────┴─────────┘

(2) ツール使用統計

BASH
hermes stats tools

# 出力:
# ┌──────────────┬──────────┬─────────┬──────────┐
# │ Tool         │ Calls    │ Avg Time│ Success  │
# ├──────────────┼──────────┼─────────┼──────────┤
# │ fs_read      │ 312      │ 0.1s    │ 99.7%    │
# │ code_python  │ 145      │ 3.2s    │ 97.2%    │
# │ web_search   │ 89       │ 2.1s    │ 98.9%    │
# │ fs_write     │ 67       │ 0.2s    │ 100%     │
# │ vision       │ 23       │ 5.8s    │ 95.7%    │
# └──────────────┴──────────┴─────────┴──────────┘

6. ヘルスチェックとアラート

(1) システムヘルス

BASH
hermes health

# 出力:
# ✅ Agent Core: Running
# ✅ Memory System: OK (156 entries, 12 MB)
# ✅ Skills Engine: OK (8 active)
# ✅ Tool Registry: OK (72 tools)
# ⚠️ Ollama Connection: Slow (2.5s response)
# ✅ OpenAI API: OK (latency 1.2s)
# ✅ Disk Space: OK (85% free)
# ⚠️ Memory Usage: 78% (consider cleanup)

(2) アラート設定

YAML
dashboard:
  alerts:
    - type: "api_error_rate"
      threshold: 0.05           # 5%エラー率
      notify: "telegram"
      
    - type: "latency_spike"
      threshold: 10             # 10秒超過
      notify: "email"
      
    - type: "disk_space"
      threshold: 0.9            # 90%使用
      notify: "telegram"
      
    - type: "memory_usage"
      threshold: 0.85           # 85%使用
      notify: "telegram"

7. カスタムダッシュボード

(1) カスタム指標

YAML
dashboard:
  custom_metrics:
    - name: "code_reviews_today"
      query: "SELECT COUNT(*) FROM tool_calls WHERE tool='code_review' AND date=today"
      display: "number"
      
    - name: "cost_savings_vs_gpt4"
      calculation: "total_cost * 0.6"  # 全てGPT-4を使うと60%高くなると仮定
      display: "trend"

(2) Webダッシュボードのカスタマイズ

BASH
# Webダッシュボードの起動
hermes dashboard --web --port 3000

# カスタムパネルレイアウト
cat > ~/.hermes/dashboard-layout.yaml << EOF
panels:
  - type: "cost_chart"
    position: "top-left"
    time_range: "30d"
    
  - type: "tool_usage"
    position: "top-right"
    top_n: 10
    
  - type: "model_distribution"
    position: "bottom-left"
    
  - type: "health_status"
    position: "bottom-right"
EOF

❓ よくある質問

Q ダッシュボードデータの保持期間は?
A デフォルト90日間。dashboard.data_retentionで設定可能、7-365日に対応。
Q Webダッシュボードの追加インストールは必要?
A 不要。hermes dashboard --webで内蔵Webサービスを直接起動、ブラウザでアクセス可能。
Q データは漏洩しますか?
A ダッシュボードデータはローカルのみ保存。Web版はデフォルトでlocalhostのみリスンし、外部に公開しません。
Q データのエクスポートは可能?
A hermes stats export --format csvで全統計データをエクスポート。CSV、JSON形式に対応。
Q マルチユーザーのダッシュボードは分離されていますか?
A はい。各Profileに独立した統計データがあります。管理者はグローバル集約を確認可能。
Q アラートの通知チャネルは?
A Telegram、Slack、Email、Webhook。複数の通知チャネルを設定可能。

📖 まとめ


📝 練習問題

  1. 基本(⭐): hermes dashboardを実行し、現在の統計データを確認し、主要指標をスクリーンショットしてください。
  2. 中級(⭐⭐): 月間予算とアラートを設定し、コスト超過シナリオをシミュレーションし、アラート発動を確認してください。
  3. 上級(⭐⭐⭐): 最も関心のある5つの指標を含むカスタムダッシュボードパネルを設計し、Webダッシュボードのレイアウトを設定してください。
Web-Tutorial.com

Web-Tutorial 技術チーム

複数の開発者によって共同維持されているプログラミングチュートリアルプラットフォーム。各チュートリアルは専門分野の開発者が執筆・レビューしています。正確で信頼性の高いコンテンツを目指しています — 問題を見つけた場合はお知らせください。

100%