Logging e debug

In caso di comportamento imprevisto, una modalità di registrazione dettagliata aiuta a diagnosticare le interazioni tra l'assistente e il tuo sito.

Attivare i log

Il componente offre una Modalità debug (Opzioni → Sicurezza), disattivata per impostazione predefinita. Una volta attivata, ogni chiamata allo strumento viene registrata insieme ai relativi parametri in administrator/logs/com_sensomcp.log.php.

Due misure di sicurezza proteggono questo log: i campi sensibili (password, token, chiavi di licenza, Download ID…) vengono oscurati, mentre i valori troppo lunghi (contenuti degli articoli, file) vengono troncati.

Il log può comunque contenere contenuti e dati personali: attivate la Modalità debug solo per effettuare una diagnosi, quindi disattivatela.

[screenshot dell'opzione Modalità debug]

Leggere gli errori

Aprite administrator/logs/com_sensomcp.log.php. Ogni riga indica la data, il livello, l'indirizzo IP, la categoria e il messaggio — lo strumento chiamato e i relativi parametri. Individuate la chiamata interessata per risalire alla causa dell'errore.

Casi frequenti

• 401 durante l'autorizzazione: sito eccessivamente blindato — consultate Risoluzione dei problemi di connessione;
• 403 sul server MCP: blocco WAF/ModSec — consultate Configurazione del server;
• aggiornamenti non disponibili: Download ID troncato o licenza scaduta;
• nessuno strumento esposto: plugin disattivato oppure dipendenza mancante (ad esempio YOOtheme Pro per l'add-on YOOtheme).