Protokollierung & Debugging
Bei unerwartetem Verhalten hilft ein detaillierter Protokollierungsmodus dabei, die Kommunikation zwischen dem Assistenten und Ihrer Website zu diagnostizieren.
Protokollierung aktivieren
Die Komponente bietet einen Debug-Modus (Optionen → Sicherheit), der standardmäßig deaktiviert ist. Nach der Aktivierung wird jeder Tool-Aufruf einschließlich seiner Parameter protokolliert in administrator/logs/com_sensomcp.log.php.
Zwei Schutzmechanismen sichern dieses Protokoll ab: sensible Felder (Passwörter, Token, Lizenzschlüssel, Download-ID usw.) werden maskiert, und lange Werte (Artikelinhalte, Dateien) werden gekürzt.
Das Protokoll kann dennoch Inhalte und personenbezogene Daten enthalten: Aktivieren Sie den Debug-Modus nur zur Fehlerdiagnose und deaktivieren Sie ihn anschließend wieder.
[Screenshot der Option „Debug-Modus“]
Fehler anzeigen
Öffnen Sie administrator/logs/com_sensomcp.log.php. Jede Zeile enthält Datum, Protokollstufe, IP-Adresse, Kategorie und Meldung — einschließlich des aufgerufenen Tools und seiner Parameter. Suchen Sie den betreffenden Aufruf, um die Fehlerursache einzugrenzen.
Häufige Fälle
- 401 bei der Autorisierung: Die Website ist zu stark abgesichert — siehe Verbindungsprobleme beheben;
- 403 auf dem MCP-Server: WAF-/ModSec-Blockierung — siehe Serverkonfiguration;
- Keine Updates verfügbar: Download-ID ist gekürzt oder die Lizenz abgelaufen;
- Keine Tools verfügbar: Plugin deaktiviert oder eine Abhängigkeit fehlt (z. B. YOOtheme Pro für das YOOtheme-Add-on).