Dépannage
Résolvez les problèmes courants d'installation, de connexion, de cron et de synchronisation Magento.
Commencez par des vérifications non destructives. Ne déconnectez pas et ne réinstallez pas le module avant d'avoir noté l'erreur et vérifié l'état actuel.
Vérifications rapides
Depuis le répertoire du projet Magento, exécutez :
bin/magento module:status Fullmetrix_Connector
bin/magento fullmetrix:statusLa première commande doit indiquer que Fullmetrix_Connector est activé. La seconde affiche la version du connecteur, l'état d'enregistrement, la file des webhooks et le nombre d'entités.
Masquez le code de connexion
fullmetrix:status affiche le code de connexion actuel. Supprimez la ligne Connection code avant de coller la sortie dans un ticket, un chat ou une capture d'écran.
Le menu Fullmetrix est absent
- Confirmez que le module est activé avec
bin/magento module:status Fullmetrix_Connector. - Exécutez
bin/magento setup:upgrade. - Dans un déploiement de production compilé, exécutez
bin/magento setup:di:compilevia votre processus de livraison habituel. - Exécutez
bin/magento cache:flush, puis déconnectez-vous de Magento et reconnectez-vous. - Vérifiez que le rôle administrateur peut accéder à la ressource ACL Fullmetrix.
Erreurs de connexion
| Erreur | Solution |
|---|---|
invalid_code_format | Copiez de nouveau le code. Il doit respecter le format FMTX-XXXX-XXXX-XXXX sans espace. |
invalid_store | Sélectionnez une vue boutique active. Vérifiez son identifiant si vous utilisez la CLI. |
| Code introuvable ou déjà utilisé | Revenez dans l'assistant Fullmetrix actif de la bonne organisation et utilisez son code actuel. |
invalid_response | Vérifiez le HTTPS sortant, le DNS, TLS, les règles de proxy et les journaux Magento. Réessayez uniquement lorsque le réseau fonctionne. |
| Erreur HTTP ou de transport | Autorisez les requêtes HTTPS vers fullmetrix.com et contrôlez le pare-feu, le proxy, le DNS et la validation du certificat. |
La boutique est connectée mais les données n'évoluent pas
-
Ouvrez Marketing > Fullmetrix et confirmez que la page affiche toujours Connected.
-
Vérifiez
bin/magento fullmetrix:status. Une file qui augmente indique que le cron ou l'envoi sortant est bloqué. -
Confirmez que le cron Magento principal est installé et actif.
-
Exécutez une fois le groupe cron du connecteur pour le diagnostic :
bin/magento cron:run --group=fullmetrix -
Consultez
var/log/system.log,var/log/exception.loget les journaux du superviseur ou du cron système autour de l'heure de l'incident. -
Vérifiez que Fullmetrix accède à l'URL publique sans mode maintenance, authentification HTTP ni défi anti-bot.
Ne reconnectez pas en premier
La déconnexion efface la connexion locale et l'état de synchronisation. Conservez l'erreur d'origine, l'état de la file et l'horodatage avant toute modification.
Informations à transmettre au support
Envoyez les éléments suivants sans mot de passe, secret, donnée client ni code de connexion :
- Version de Magento ou Adobe Commerce
- Version de PHP
- Version du connecteur Fullmetrix
- Identifiant de la vue boutique et URL publique
- Message d'erreur exact et heure approximative avec fuseau horaire
- État du cron et évolution éventuelle de la file Fullmetrix
- Lignes pertinentes et anonymisées des journaux Magento
- Informations sur le pare-feu, le proxy inverse, le mode maintenance ou la protection anti-bot
Pour supprimer l'intégration, suivez Déconnexion, désactivation ou désinstallation.