English 中文 العربية 日本語 Português

Hermes Agent: Dashboard

Última atualização: 2026-08-31

O Dashboard é o painel de controle do Hermes Agent — consumo de Tokens, tendências de custo, frequência de uso de ferramentas, crescimento de memória, todos os dados de um coup d'oeil.

💡 Dica: O Dashboard oferece interface CLI em texto e Web gráfica. Verificar regularmente ajuda a otimizar custos e detectar anomalias.

📋 Pré-requisitos: Lição 4 — Configuração de Modelos, Lição 10 — Tarefas Agendadas

1. O Que Você Vai Aprender

# Conteúdo
❶ Visão geral do Dashboard
❷ Estatísticas de uso e análise de custos
❸ Monitoramento de performance
❹ Health checks e alertas
❺ Dashboard personalizado

2. História

(1) Problema: Não Sabe Quanto Gastou com IA

Bob usou o Hermes por um mês sem saber quantos Tokens consumiu ou quanto gastou. No final do mês, a fatura da API foi uma surpresa.

(2) Solução: Monitoramento em Tempo Real pelo Dashboard

Alice verifica o dashboard diariamente:

BASH 
hermes dashboard

# ┌─ Hermes Dashboard ─────────────────────┐
# │                                         │
# │ 💰 Custo mensal: $14.32 / Orçamento $50│
# │ 📊 Tokens: 3.2M / 10M                 │
# │ ⏱️ Resposta média: 2.3s                │
# │ 🔧 Chamadas de ferramenta: 847         │
# │ 📝 Entradas de memória: 156            │
# │                                         │
# │ 📈 Tendência de custo (7 dias)          │
# │ 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 (hoje até agora)│
# └─────────────────────────────────────────┘

3. Visão Geral do Dashboard

(1) Métricas Principais

Métrica Descrição Unidade
Custo mensal Custo total de chamadas API USD
Tokens consumidos Input + Output Tokens Milhões
Tempo de resposta médio Latência de inferência LLM Segundos
Chamadas de ferramenta Frequência de uso por ferramenta Contagem
Entradas de memória Quantidade de memória de longo prazo Contagem
Uso de habilidades Chamadas por habilidade Contagem

(2) Formas de Acesso

BASH 
hermes dashboard
hermes dashboard --web --port 3000
hermes stats cost
hermes stats tokens
hermes stats tools

4. Estatísticas de Uso e Análise de Custos

(1) Relatório de Custos

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) Análise por Tipo de Tarefa

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) Orçamento de Custos

YAML 
dashboard:
  budget:
    monthly_limit: 50
    warning_threshold: 0.8
    daily_limit: 5
  alerts:
    - type: "cost_threshold"
      threshold: 40
      notify: "telegram"
    - type: "daily_exceed"
      notify: "telegram"

5. Monitoramento de Performance

(1) Tempo de Resposta

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) Estatísticas de Uso de Ferramentas

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. Health Checks e Alertas

(1) Saúde do Sistema

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) Configuração de Alertas

YAML 
dashboard:
  alerts:
    - type: "api_error_rate"
      threshold: 0.05
      notify: "telegram"
    - type: "latency_spike"
      threshold: 10
      notify: "email"
    - type: "disk_space"
      threshold: 0.9
      notify: "telegram"
    - type: "memory_usage"
      threshold: 0.85
      notify: "telegram"

7. Dashboard Personalizado

(1) Métricas Personalizadas

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"
      display: "trend"

(2) Layout do Web Dashboard

BASH 
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

❓ Perguntas Frequentes

P: Por quanto tempo os dados são retidos? R: Padrão 90 dias. Configurável via dashboard.data_retention de 7 a 365 dias.

P: Web dashboard precisa de instalação extra? R: Não. hermes dashboard --web inicia o servidor web embutido, acesse pelo navegador.

P: Dados podem vazar? R: Dados do dashboard ficam apenas localmente. Web versão escuta apenas localhost por padrão.

P: Posso exportar dados? R: hermes stats export --format csv exporta todas as estatísticas. Formatos CSV e JSON.

P: Dashboards de múltiplos usuários são separados? R: Sim. Cada Profile tem estatísticas independentes. Admins podem ver resumo global.

P: Quais canais de notificação para alertas? R: Telegram, Slack, Email, Webhook. Múltiplos canais configuráveis.

📖 Resumo

📝 Exercícios

  1. Básico (⭐): Execute hermes dashboard, visualize estatísticas atuais, capture métricas-chave.
  2. Intermediário (⭐⭐): Configure orçamento mensal e alertas, simule cenário de custo excedido, verifique alertas disparados.
  3. Avançado (⭐⭐⭐): Desenhe um dashboard personalizado com suas 5 métricas mais importantes, configure layout do Web dashboard.
Web-Tutorial.com

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

100%