Risoluzione dei problemi
Risolvi i problemi comuni di installazione, connessione, cron e sincronizzazione Magento.
Inizia con controlli non distruttivi. Non disconnettere o reinstallare il modulo prima di aver registrato l'errore e verificato lo stato corrente.
Controlli rapidi
Dalla directory del progetto, esegui:
bin/magento module:status Fullmetrix_Connector
bin/magento fullmetrix:statusIl primo comando deve indicare che Fullmetrix_Connector è abilitato. Il secondo mostra versione, registrazione, coda webhook e conteggi delle entità.
Oscura il codice di connessione
fullmetrix:status mostra il codice corrente. Rimuovi la riga Connection code prima di incollare l'output in ticket, chat o schermate.
Il menu Fullmetrix non appare
- Conferma il modulo con
bin/magento module:status Fullmetrix_Connector. - Esegui
bin/magento setup:upgrade. - In produzione compilata, esegui
bin/magento setup:di:compiletramite il normale processo. - Esegui
bin/magento cache:flush, poi disconnettiti e accedi nuovamente. - Verifica l'accesso del ruolo alla risorsa ACL Fullmetrix.
Errori di connessione
| Errore | Soluzione |
|---|---|
invalid_code_format | Copia di nuovo il codice. Deve avere formato FMTX-XXXX-XXXX-XXXX senza spazi. |
invalid_store | Seleziona una vista attiva. Controlla l'ID se usi la CLI. |
| Codice non trovato o già usato | Torna alla configurazione attiva dell'organizzazione corretta e usa il codice corrente. |
invalid_response | Controlla HTTPS in uscita, DNS, TLS, proxy e log Magento. Riprova solo dopo aver risolto la rete. |
| Errore HTTP o di trasporto | Consenti HTTPS verso fullmetrix.com e controlla firewall, proxy, DNS e certificati. |
Connesso, ma i dati non si aggiornano
-
Apri Marketing > Fullmetrix e conferma Connected.
-
Controlla
bin/magento fullmetrix:status. Una coda crescente indica cron o invio in uscita bloccati. -
Verifica che il cron Magento principale sia installato e attivo.
-
Esegui una volta il gruppo del connettore per diagnosi:
bin/magento cron:run --group=fullmetrix -
Controlla
var/log/system.log,var/log/exception.loge i log del supervisore o cron di sistema nell'orario del problema. -
Verifica che Fullmetrix raggiunga l'URL pubblico senza manutenzione, autenticazione HTTP o sfide anti-bot.
Non riconnettere come primo tentativo
La disconnessione cancella connessione locale e stato di sincronizzazione. Conserva errore, stato della coda e ora prima di cambiare la connessione.
Informazioni per il supporto
Invia quanto segue senza password, segreti, dati cliente o codice di connessione:
- Versioni di Magento o Adobe Commerce e PHP
- Versione del connettore Fullmetrix
- ID della vista negozio e URL pubblico
- Errore esatto e ora approssimativa con fuso orario
- Stato del cron e andamento della coda Fullmetrix
- Righe pertinenti e oscurate dei log Magento
- Dettagli su firewall, proxy, manutenzione o protezione anti-bot
Per rimuovere l'integrazione, segui Disconnettere, disabilitare o disinstallare.