Phase 11: Performance monitoring dashboard and enhanced documentation

README.md

@@ -18,6 +18,7 @@ Un agente configurabile basato su DeepAgents che supporta più provider LLM.
 - **Web UI**: Interfaccia web per gestione configurazioni
 - **Comandi integrati**: Comandi speciali con prefisso "/" per gestione rapida
 - **Monitoraggio**: Sistema di logging e monitoraggio delle performance
+- **Dashboard performance**: Monitoraggio dettagliato delle performance
 - **Sistema di plugin**: Estendi le funzionalità con plugin personalizzati
 - **Supporto multilingue**: Interfaccia in italiano e inglese
 
@@ -210,6 +211,7 @@ Quando interagisci con l'agente, puoi usare comandi speciali preceduti da "/" pe
 /clear              - Pulisce lo schermo
 /plugins            - Elenca i plugin disponibili
 /language           - Cambia la lingua dell'interfaccia
+/performance        - Mostra il report delle performance
 /exit, /quit        - Esci dall'agente
 ```
 
@@ -232,6 +234,16 @@ Ollama URL: http://192.168.0.50:11434
 👤 You: Elenca i file nella directory corrente
 🤖 MaxClaw: [Esegue ls e mostra i file]
 
+👤 You: /performance
+📊 Performance Report (Last 24 hours)
+==================================================
+
+📈 Request Statistics:
+  Total Requests: 150
+  Total Errors: 2
+  Error Rate: 1.33%
+  Avg Response Time: 0.245s
+
 👤 You: /exit
 👋 Goodbye!
 ```
@@ -495,6 +507,49 @@ Per aggiungere una nuova lingua:
 3. Traduci tutti i valori
 4. L'agente rileverà automaticamente la nuova lingua
 
+## Monitoraggio Performance
+
+MaxClaw Agent include un sistema avanzato di monitoraggio delle performance.
+
+### Dashboard Performance
+
+Il dashboard raccoglie e analizza:
+- Richieste API e tempi di risposta
+- Utilizzo degli strumenti
+- Utilizzo dei provider
+- Statistiche di sistema (CPU, memoria, disco)
+- Errori e tassi di successo
+
+### Visualizzare le Performance
+
+```bash
+# Usa il comando /performance
+/performance
+
+# Oppure esegui lo script direttamente
+python dashboard.py
+```
+
+### Report Disponibili
+
+Il report include:
+- Statistiche richieste (totale, errori, tasso di errore)
+- Distribuzione codici di stato
+- Endpoint più utilizzati
+- Utilizzo degli strumenti (chiamate, tasso di successo, durata media)
+- Utilizzo dei provider
+- Statistiche di sistema
+
+### Configurazione
+
+I dati di performance vengono salvati in `~/.maxclaw/performance/` e includono:
+- Richieste API
+- Errori
+- Tempi di risposta
+- Utilizzo strumenti
+- Utilizzo provider
+- Statistiche di sistema
+
 ## Test
 
 Esegui la suite di test:
@@ -566,6 +621,7 @@ MaxClaw Agent include un sistema di monitoraggio e logging:
 - **Statistiche di sistema**: Monitoraggio di uptime, richieste, errori
 - **Metriche di performance**: Tempi di risposta, utilizzo cache
 - **Report di stato**: Visualizzazione completa dello stato del sistema
+- **Dashboard performance**: Monitoraggio avanzato delle performance
 
 ## Sicurezza