Dépannage
Résoudre les problèmes du module Magento, du menu introuvable aux erreurs de connexion et aux données qui n'avancent plus.
Commencez toujours par les vérifications qui ne changent rien. Ne cliquez pas sur Déconnecter, ni dans Magento ni dans Fullmetrix, pour « repartir de zéro ». Dans Magento, la déconnexion efface le lien avec Fullmetrix et le code ne peut pas être réutilisé. Dans Fullmetrix, elle supprime les données importées.
Plusieurs vérifications de cette page se font en ligne de commande. Transmettez-les à votre développeur.
Les deux commandes de diagnostic
Depuis le dossier du projet Magento, votre développeur exécute ces deux commandes.
bin/magento module:status Fullmetrix_Connector
bin/magento fullmetrix:statusLa première confirme que le module est activé. La seconde affiche l'état de la connexion, ligne par ligne.
| Ligne | Ce qu'elle indique |
|---|---|
Version | La version du module installée |
Registered | yes si la boutique est connectée à Fullmetrix, no sinon |
Connection code | Le code utilisé. Masquez cette ligne avant de partager la sortie. |
Webhooks | enabled si les changements sont bien transmis |
Queue | Le nombre de changements en attente d'envoi et l'ancienneté du plus vieux |
orders, customers, products... | Le nombre d'éléments que la boutique peut envoyer, par type |
Une file Queue qui reste à 0 ou presque est normale. Une file qui grossit d'heure en heure signifie que le cron ne tourne pas ou que l'envoi vers Fullmetrix est bloqué.
Le menu Fullmetrix n'apparaît pas dans Magento
- Déconnectez-vous de l'administration Magento puis reconnectez-vous. Le menu est souvent mis en cache dans la session.
- Votre développeur vérifie que le module est activé avec
bin/magento module:status Fullmetrix_Connector. S'il ne l'est pas, il exécutebin/magento module:enable Fullmetrix_Connector. - Il exécute
bin/magento setup:upgrade, puisbin/magento setup:di:compilesi la boutique est en mode production, puisbin/magento cache:flush. - Si vous utilisez un rôle administrateur personnalisé, vérifiez que la ressource Fullmetrix est cochée, comme expliqué dans Compatibilité.
Messages d'erreur à la connexion
Quand la connexion échoue, Magento affiche Échec de la connexion suivi d'une raison. En ligne de commande, la raison suit le message Connexion echouee.
| Raison affichée | Ce qu'elle veut dire | Que faire |
|---|---|---|
invalid_code_format | Le code n'a pas la forme FMTX-XXXX-XXXX-XXXX | Recopiez-le depuis Fullmetrix. Il ne contient jamais les lettres O et I ni les chiffres 0 et 1. |
invalid_store | La vue boutique choisie n'existe pas ou n'est pas active | Choisissez une vue active. En ligne de commande, vérifiez le numéro passé à --store-id. |
| Code de connexion introuvable | Ce code n'existe pas dans Fullmetrix | Recopiez le code affiché dans votre organisation, sans caractère en trop |
| Plateforme incorrecte pour ce code | Le code a été créé pour une autre plateforme | Dans Fullmetrix, revenez au choix de la plateforme, choisissez Magento, puis copiez le code affiché et réessayez |
| Ce code est déjà associé à un autre site | Une boutique a déjà accepté ce code | Voir la section suivante |
| Trop de tentatives, réessayez dans quelques minutes. | Trop d'essais en peu de temps | Attendez dix minutes avant de réessayer |
| Cette boutique est déjà connectée à une autre Organization. | La boutique appartient déjà à une autre organisation Fullmetrix | Utilisez cette organisation, ou retirez-en la boutique d'abord |
| Cette boutique a déjà bénéficié d'un essai Fullmetrix... | La période d'essai a déjà servi pour cette boutique | Un abonnement est nécessaire, voir Facturation |
invalid_response, HTTP suivi d'un nombre, ou un message réseau | Le serveur n'a pas pu joindre Fullmetrix correctement | Votre développeur vérifie que le serveur peut ouvrir des connexions HTTPS sortantes vers fullmetrix.com (pare-feu, proxy, DNS, certificats) |
Le code est « déjà associé à un autre site »
Un code ne sert qu'une fois. Ce message apparaît quand vous réessayez avec un code déjà accepté, par exemple après avoir cliqué sur Déconnecter dans Magento, ou si une autre installation (une préproduction, par exemple) l'a utilisé avant.
Si la carte de la boutique dans Fullmetrix fonctionne toujours, il n'y a rien à faire, la connexion est en place. Si vous avez déconnecté la boutique dans Magento et voulez la reconnecter, il faut un nouveau code. Ouvrez Paramètres, puis Intégrations, cliquez sur Déconnecter sur la carte Magento, confirmez, puis ajoutez de nouveau la boutique pour obtenir un code neuf. Cette opération efface les données importées dans Fullmetrix, qui sont ensuite importées de nouveau depuis votre boutique.
La boutique est connectée mais les données n'avancent plus
-
Dans Magento, ouvrez Marketing, puis Fullmetrix, et vérifiez que la pastille Connecté est toujours affichée.
-
Votre développeur exécute
bin/magento fullmetrix:statuset regarde la ligneQueue. Si elle grossit, le cron ne tourne pas ou l'envoi est bloqué. -
Il vérifie que le cron de Magento est installé et actif, puis lance une fois le groupe Fullmetrix pour tester.
bin/magento cron:run --group=fullmetrix -
Il consulte
var/log/system.logetvar/log/exception.logautour de l'heure du problème. -
Dans Fullmetrix, ouvrez Paramètres, puis Intégrations, et lisez la carte Magento. Un message rouge précise la cause de la dernière erreur.
La carte Fullmetrix indique que la boutique est injoignable
Le message La dernière synchronisation n'a pas pu joindre votre boutique. Vérifiez qu'elle est en ligne et accessible publiquement. Aucune donnée n'a été mise à jour. veut dire que Fullmetrix n'a pas pu appeler votre site. Vérifiez que la boutique est en ligne, qu'elle n'est pas en mode maintenance et qu'aucune protection ne bloque les adresses en /fullmetrix/api/. Si vous utilisez Cloudflare, suivez Cloudflare et pare-feu.
Après une erreur, le bouton Synchroniser laisse la place à Reprendre et Réinitialiser. Une fois la cause corrigée, cliquez sur Reprendre pour repartir de l'endroit où l'import s'était arrêté. Si Reprendre n'est pas proposé, cliquez sur Réinitialiser, qui remet l'avancement à zéro et relance la synchronisation sans effacer les commandes déjà importées. C'est vrai aussi quand la carte affiche Synchro auto désactivée après N erreurs consécutives, même si ce message parle du bouton Synchroniser. Les autres états de la carte sont décrits dans État de la synchronisation.
Des erreurs apparaissent après une mise à jour du module
Sur une boutique en mode production, chaque mise à jour du module doit être suivie de bin/magento setup:upgrade, bin/magento setup:di:compile et bin/magento cache:flush. Si l'une de ces commandes a été oubliée, des erreurs peuvent apparaître dans l'administration ou au moment du paiement. Votre développeur relance les trois commandes dans cet ordre.
Le suivi des visiteurs ne reçoit rien
- Vérifiez que la boutique est connectée, avec la pastille Connecté dans Magento.
- Videz le cache de pages de Magento ou de votre cache externe, pour que les pages servies contiennent le suivi.
- Faites votre test en acceptant les cookies si un bandeau de consentement est en place.
- Contrôlez la réception dans Script de suivi.
Écrire au support
Si le problème persiste, contactez-nous avec les éléments suivants.
- La version de Magento ou d'Adobe Commerce et la version de PHP.
- La sortie de
bin/magento fullmetrix:status, avec la ligneConnection codeeffacée. - La vue boutique connectée et l'adresse publique de la boutique.
- Le message exact et l'heure où il est apparu.
- La présence éventuelle d'un pare-feu, de Cloudflare, d'un mode maintenance ou d'un mot de passe sur le site.
- Les lignes utiles des journaux Magento, sans données de clients.
N'envoyez jamais de mot de passe ni le code de connexion.