Résumé : Utilisez la vue d'ensemble Interfaces pour vérifier si les interfaces en production fonctionnent correctement, quand elles s'exécutent et quels journaux ou données d'exécution nécessitent votre attention.

Prérequis : - Vous devez avoir accès à Interfaces. - Vous devez avoir l'autorisation de consulter les journaux d'interface pour ouvrir Insights, Runs, Logs ou Data d'une exécution.

Surveiller les interfaces depuis la vue d'ensemble

La page Interfaces est le point de départ de la surveillance quotidienne. Elle affiche chaque interface, sa planification, sa prochaine exécution prévue et le résultat de la dernière exécution.

Comprendre ce qu'affiche la vue d'ensemble

• Interfaces sont les connexions BrynQ qui transfèrent ou synchronisent des données entre applications.
• Live affiche les interfaces actives ou disponibles. Utilisez cette vue pour la surveillance quotidienne.
• Draft affiche les interfaces encore en préparation. Utilisez cette vue pour vérifier un travail qui n'est pas encore en production.
• Next run indique quand BrynQ prévoit la prochaine exécution de l'interface. Si l'interface est manuelle, la ligne affiche Manual au lieu d'une heure planifiée.
• Schedule indique comment l'interface est déclenchée, par exemple selon une planification, manuellement ou après une autre interface.
• Last run affiche le dernier résultat connu, par exemple Successful, Completed, Failed, Stopped ou Never run.

Trouver l'interface à surveiller

• Dans la navigation de gauche, ouvrez Interfaces.
• En haut de la page, utilisez Search for interfaces by name pour trouver l'interface par son nom affiché.
• Dans le sélecteur de vue en haut à droite, choisissez Live pour surveiller la production ou Draft pour les interfaces encore en préparation.
• Dans Live, utilisez Filter dans la zone de filtres en haut pour restreindre la liste par statut.
• Si une interface est désactivée, ouvrez la section Inactive sous la liste des interfaces actives.

Lire la ligne de l'interface

• Dans la colonne Interfaces, vérifiez le nom de l'interface et les applications connectées. Vous confirmez ainsi que vous consultez la bonne configuration source et cible.
• Dans Next run, vérifiez si l'interface est planifiée, Manual, Never run ou retardée avec Starts soon.
• Dans Schedule, vérifiez que la planification ou le déclencheur correspond à ce que vous attendez.
• Dans Last run, cliquez sur le badge de statut pour ouvrir l'historique des exécutions de cette interface.
• À droite de la ligne, utilisez Insights pour ouvrir le panneau de surveillance de cette interface.
• N'utilisez Run que si vous souhaitez délibérément lancer une exécution manuelle. Si l'interface est active, le bouton peut afficher à la place un état en cours ou en arrêt.

Utiliser Insights pour un contrôle rapide

• À droite de la ligne de l'interface, sélectionnez Insights. Le panneau s'ouvre sur l'onglet Overview.
• En haut du panneau, vérifiez le nom de l'interface, les applications connectées, le statut, la planification, la dernière exécution, la prochaine exécution et l'ID de l'interface.
• Si vous voyez l'avertissement de dry run, l'interface fonctionne en mode aperçu. BrynQ récupère et traite les données, mais n'applique aucune modification dans l'application cible.
• Si vous voyez l'avertissement « en développement », considérez que l'interface n'est pas encore prête pour la production.
• Dans Success rate, vérifiez la fiabilité des exécutions récentes.
• Dans Records processed, vérifiez le volume de données traité par les exécutions récentes.
• Dans Total runs, vérifiez l'étendue de l'historique d'exécution disponible.
• Dans Records Processed, comparez les enregistrements ajoutés, mis à jour, supprimés, ignorés ou en échec.
• Dans Run Results, comparez les exécutions réussies, en échec, arrêtées et en cours.
• Utilisez 7d, 14d ou 30d dans les en-têtes des graphiques pour changer la période.
• Dans Recent Runs, sélectionnez une ligne d'exécution lorsque vous avez besoin du détail exact.
• Si The most recent run encountered errors. s'affiche, sélectionnez View run dans cet avertissement pour ouvrir directement l'exécution en échec.

Consulter l'historique des exécutions

• Dans le panneau Insights, ouvrez l'onglet Runs.
• Utilisez les boutons de filtre en haut de Runs pour affiner la liste :
• All affiche toutes les exécutions de la période sélectionnée.
• Success affiche les exécutions réussies.
• Error affiche les exécutions en échec à examiner.
• Stopped affiche les exécutions arrêtées.
• Running affiche les exécutions encore en cours.
• Lisez chaque ligne d'exécution selon le statut, l'heure de début, le nombre de journaux et le nombre d'enregistrements.
• Sélectionnez une ligne d'exécution pour ouvrir la page Run Detail.

Examiner les journaux et les données d'une exécution

• Sur la page Run Detail, utilisez Back to interfaces en haut à gauche pour revenir à la vue d'ensemble.
• Dans le sélecteur d'exécutions à gauche, choisissez All logs pour voir les journaux des 30 derniers jours, ou choisissez une exécution pour n'examiner que celle-ci.
• Utilisez les filtres du sélecteur d'exécutions à gauche pour restreindre les exécutions par All, Success, Error, Stopped ou Running.
• Ouvrez l'onglet Logs pour consulter les messages de l'exécution sélectionnée. Utilisez Search for logs by message or reload id pour trouver un message précis.
• Utilisez le bouton Export à droite de la barre d'outils des journaux pour télécharger les données de journal affichées.
• Ouvrez l'onglet Data pour examiner les enregistrements de l'exécution sélectionnée. Cet onglet montre les enregistrements nouveaux, modifiés, supprimés, ignorés ou en échec.
• Dans Data, sélectionnez View records pour un scénario lorsque vous avez besoin du détail par enregistrement, et utilisez Open technical view lorsque le support ou une analyse technique nécessite la vue des données brutes.
• N'utilisez Re-run en haut à droite que si vous souhaitez relancer l'interface et que le bouton est disponible.

Plus d'informations

Commencez par la vue d'ensemble pour un contrôle rapide. Ouvrez Insights lorsque la ligne affiche un Last run inattendu, un Next run retardé ou un statut à examiner.

Exemple : Si l'interface Personio to Nmbrs Employees affiche Failed dans Last run, ouvrez Insights, sélectionnez View run et consultez Logs. Si la première erreur indique que l'e-mail d'un salarié est manquant, ouvrez Data pour trouver l'enregistrement concerné. Après avoir corrigé les données source, n'utilisez Re-run que si vous souhaitez que BrynQ traite à nouveau l'interface immédiatement.