Journal des appels

Le journal des appels liste les appels d'outils reçus par un serveur : il sert à vérifier que votre IA l'utilise et à comprendre un échec.

Sur téléphone, l'onglet « Journaux » liste vos serveurs : touchez-en un pour ouvrir directement son journal.

Pour des chiffres agrégés (par jour, par outil, par client), voir le tableau de bord.

Ce qui est journalisé

Ouvrez l'onglet « Journal » du serveur. Chaque appel d'outil compté (venant d'une IA via MCP ou du bac à sable) produit une ligne :

• « Date » de l'appel ;
• « Outil » appelé ;
• « Statut » (voir plus bas) ;
• « Source » : « IA » pour un appel reçu par MCP, « Bac à sable » pour un test ;
• « Code HTTP » renvoyé par l'API cible, vide si elle n'a pas répondu ;
• « Durée », détaillée en « Durée amont » (attente de votre API) et « Durée MCP » (temps passé dans Voozeo) ;
• pour un appel en échec seulement : l'« Origine », l'« Étape » et un court « Message » (voir Lire les étapes).

Les lignes sont affichées par 20, les plus récentes d'abord. « Actualiser » recharge la liste et « Charger plus » affiche les suivantes. Les demandes qui ne comptent pas dans le quota (liste des outils, par exemple) n'apparaissent pas.

Cliquez sur une ligne (ou appuyez sur Entrée sur le nom de l'outil) pour ouvrir le détail de l'appel : tous les champs, le message complet et, si le mode diagnostic était actif, sa capture. Sur téléphone, les lignes sont des cartes et le détail s'ouvre dans une feuille. Les lignes enregistrées avant cette fonction montrent des cellules vides pour les nouvelles colonnes.

Ce qui n'est jamais journalisé

Par défaut, ni les arguments des appels, ni les résultats, ni votre clé MCP, ni les secrets de l'API cible ne sont enregistrés dans le journal. Vous n'y voyez que le fonctionnement de l'appel, jamais son contenu. La seule exception est le mode diagnostic, facultatif ; même alors, les en-têtes et les secrets ne sont jamais conservés.

Durée de conservation

Les lignes sont conservées pendant la durée fixée par votre offre (affichée au-dessus de la liste et sur l'écran « Offres »), puis supprimées automatiquement ; le contenu capturé par le mode diagnostic est conservé 30 jours. Les lignes sont aussi supprimées avec le serveur. Voir Quotas et offres.

Lire les statuts

• « Réussi » : l'outil a répondu sans erreur.
• « Erreur » : l'appel a échoué (API cible injoignable, délai dépassé, statut HTTP d'erreur…). Le « Code HTTP » aide à comprendre ; voir API cible.
• « Quota atteint » : l'appel a été refusé car le quota mensuel est épuisé ; votre API n'a pas été appelée (détail).

Si le journal est vide, connectez une IA (Connecter son IA) ou lancez un test.

Lire les étapes

Pour un appel en échec, l'« Étape » indique où il a échoué et l'« Origine » qui en est la cause : « API cible » (votre API a répondu par une erreur) ou « Voozeo ».

• « Outil inconnu » : l'IA a appelé un outil qui n'existe pas ou qui est désactivé. Le « Message » est « Unknown tool » et l'outil demandé figure dans le détail. Voir Outil inconnu.
• « Entrée invalide » : l'IA a envoyé des arguments invalides, ou aucun pour un paramètre obligatoire. Voir Paramètre manquant.
• « URL refusée » : l'adresse cible a été refusée par la protection réseau de Voozeo.
• « Réseau ou délai dépassé » : votre API n'a pas répondu en 10 secondes ou n'a pas pu être jointe.
• « Erreur HTTP » : votre API a répondu par un statut d'erreur (colonne « Code HTTP »).
• « Quota » : le quota mensuel est épuisé.
• « Erreur interne » : un problème côté Voozeo ou un défaut de configuration (par exemple un réglage d'authentification manquant).

Le « Message » est toujours en anglais et c'est une phrase courte et fixe, par exemple « Upstream returned HTTP 404 Not Found ». Il ne contient jamais de données de vos appels, sauf si le mode diagnostic est actif.

Filtrer le journal

Au-dessus de la liste, filtrez par outil (nom exact), origine, étape, source, ou par texte dans le message. Le nombre d'appels correspondants est affiché (« 10 000+ » au-delà). Les filtres texte s'appliquent après une courte pause ; « Effacer les filtres » remet tout à zéro. Sur téléphone, les filtres s'ouvrent dans une feuille avec le bouton « Filtres ».

Top des erreurs

Le bloc « Top des erreurs », au-dessus de la liste, regroupe les appels en échec des 7 ou 30 derniers jours (ou de toute la durée de conservation de votre offre, si elle dépasse 30 jours) par outil, origine, étape et code HTTP, avec leur nombre et leur dernière occurrence (10 groupes au plus). Cliquez sur un groupe pour filtrer le journal dessus. Si plus de 10 000 appels ont été trouvés, le résultat est signalé comme partiel.

Mode diagnostic

Quand le message ne suffit pas, activez l'interrupteur « Mode diagnostic » en haut de l'onglet. Il est désactivé par défaut et ne concerne que ce serveur.

• Ce qui est capturé : pour chaque appel, la requête envoyée à l'API cible (méthode, URL, corps), les 2 premiers Ko de la réponse, le résultat renvoyé à l'IA et, pour une erreur interne, la pile d'exécution. Les en-têtes ne sont jamais capturés.
• Les secrets sont masqués : la clé, le jeton ou le mot de passe de votre API, ainsi que les champs nommés comme un mot de passe ou un jeton, sont remplacés par *** avant l'enregistrement.
• Les captures sont conservées 30 jours, visibles des membres de votre espace (et de l'équipe Voozeo quand vous demandez de l'aide), et affichées dans le bloc « Capture » du détail de l'appel.
• Désactiver l'interrupteur arrête les nouvelles captures. Les captures existantes expirent sous 30 jours.

L'activation et la désactivation du mode figurent dans votre journal d'activité. Voir aussi Le contenu de mes appels est-il conservé ?.

Exemple

Votre IA répond « je n'ai pas pu récupérer la commande ». Dans « Journal », vous voyez la ligne : get_order, « Erreur », code HTTP 404, 120 ms. L'API cible a répondu « introuvable » : l'identifiant donné par l'utilisateur n'existe pas. Aucun argument n'est affiché : c'est volontaire.