Statistiques d'appels d'outils et alertes d'échec

Où le trouver ?

En haut de la page « Outils », il y a trois onglets : « Outils », « Statistiques d'appels » et « Paramètres de journal et d'alerte ». Tous les membres peuvent voir les statistiques ; modifier les réglages demande le rôle propriétaire ou administrateur.

Statistiques d'appels

Choisissez une plage de dates en haut (aujourd'hui, hier, les 7, 30 ou 90 derniers jours, toute la période ou une période personnalisée). Par défaut, les 7 derniers jours.

Un appel compte comme réussi quand votre outil renvoie une réponse 2xx, même si la réponse elle-même indique une erreur. Si la nouvelle tentative en cas d'échec est activée, tous les essais comptent pour un seul appel.

• Résumé : nombre d'appels réussis et échoués, taux de réussite et durée moyenne.
• Graphiques : appels par jour, appels échoués par jour et répartition par outil. Les appels de test ne comptent pas dans les graphiques, mais ils apparaissent dans le journal d'appels.
• Alertes ouvertes : les outils qui échouent continuellement sont listés dans un seul encadré en haut de la page, un par ligne ; le lien de chaque ligne mène aux appels échoués de cet outil. L'historique des alertes fermées est en bas de la page.
• Journal d'appels : filtrez par outil, statut et source (agent, étape de choix, étape d'appel d'outil, test). Cliquer sur une ligne montre les détails de l'erreur, le statut HTTP, la durée, la taille de la réponse, le texte d'erreur de l'outil, les champs envoyés (adresses e-mail et longs numéros masqués), ainsi que l'agent et la session. Le corps d'une réponse réussie n'est pas conservé.

Les outils de l'agent de boutique (recherche de produits, statut de commande…) ne sont pas comptés ici ; vous les trouverez dans Intégrations › « Statistiques d'actions ».

Paramètres de journal et d'alerte

• « Durée de conservation » : combien de jours les détails des appels sont conservés (1 à 30 jours, 7 par défaut). Les compteurs sont permanents ; seuls les détails sont supprimés à la fin de la période.
• « Fenêtre de temps » et « Seuil » : une alerte s'ouvre quand au moins le nombre d'appels du seuil (1 à 1000, 5 par défaut) échouent dans la fenêtre de temps (5 à 1440 minutes, 15 par défaut).

Quand un appel réussit et que le nombre d'échecs passe sous le seuil, l'alerte se ferme d'elle-même et une notification « fonctionne à nouveau » est envoyée. Un outil avec une alerte ouverte affiche le badge « En échec » dans la liste des outils.

La fenêtre de temps et le seuil servent aussi à l'alerte d'échec du fournisseur dans les intégrations ; les alertes d'intégration partent avec la notification « Échec d'une étape d'intégration ». Choisissez le canal des alertes d'outils (Slack, Teams, Telegram, e-mail) avec la notification « Échec d'outil » sur la page « Alertes et notifications ».