Les logs d'intégration

Modifié le 28/05/2022 10:53

Attention : Il n'y a pas de retour arrière possible en cas de purge de logs d'intégration par erreur. Les impacts que la suppression de données peut avoir au sein de votre plateforme ne sont pas pris en charge par le Support EasyVista.
Definition

Un log d'intégration est un fichier texte généré par l'ordonnanceur smoScheduler à la fin de l'exécution d'un modèle d'intégration. Il permet d'avoir un compte-rendu de l'intégration des données dans la base Service Manager et d'afficher la liste des erreurs nécessitant une action corrective.

EndDefinition

Remarques

Attention

  • En cas de purge par erreur de logs d'intégration, il n'y a pas de retour arrière possible.

Bonnes pratiques

  • Affichez la liste des erreurs pour repérer les libellés multilingues que l'intégration n'a pas permis de mettre à jour dans les tables liées.
  • Mettez en place une tâche planifiée sur chaque environnement de la plateforme pour purger automatiquement et régulièrement les logs d'intégration  - Open url.png voir Procédure
    • Utilisez la requête parent dédiée Log d'intégration.
    • Le paramètre divers Supprimer les logs d'intégration "Plus anciens que" permet de spécifier le nombre de jours au-delà duquel les logs d'intégration vont être automatiquement supprimés.

Accès menu

Administration > Intégration > Log d'intégration

Description de l'écran

        Integration log.png

Détail

Modèle d'intégration : Nom du modèle d'intégration.

Statut : Statut de l'intégration, mis à jour automatiquement à la fin de celle-ci.

  • Le statut Échec indique que l'intégration des données n'a pas pu être réalisée. Les points bloquants sont recensés dans l'onglet Erreurs.
  • Le statut Réussie avec avertissements indique que l'intégration a été réalisée. Les points à vérifier sont recensés dans l'onglet Erreurs.

Date de début : Date/Heure à laquelle a débuté l'intégration.

Durée (H:M:S) : Durée de l'intégration, exprimée en heures/minutes/secondes/millisecondes.

Connecteur : Nom du connecteur utilisé lors de l'intégration des données.

Champ d'unicité : Liste des champs utilisés comme clé d'unicité dans le modèle d'intégration.

Type de données : Provenance des données tierces :

  • CSV : Fichier texte au format .csv.
  • datasource : Base de données.

Qté lignes : Nombre d'enregistrements total traités au cours de l'intégration.

Intervenant : Nom de l'utilisateur qui a lancé l'intégration.

Qtés lignes ajoutées : Nombre de nouveaux enregistrements insérés dans la base Service Manager au cours de l'intégration.

  • Allez sur l'onglet Enregistrements pour afficher la liste des enregistrements dans chaque table du connecteur.

Qtés lignes modifiées : Nombre d'enregistrements modifiés dans la base Service Manager au cours de l'intégration.

  • Allez sur l'onglet Enregistrements pour afficher la liste des enregistrements dans chaque table du connecteur.

Enregistrements

Nombre d'enregistrements ajoutés et modifiés dans chaque table du connecteur utilisé par le modèle d'intégration.

  • Pour consulter le détail des enregistrements, cliquez sur les liens hypertextes Ajoutés / Modifiés.
             List records added.png

Erreurs

Liste des erreurs survenues au cours de l'intégration.

  • Le numéro de ligne fait référence à la ligne dans le fichier de données ayant servi à l'intégration.
             Integration errors.png

Procédures et Assistants

Comment consulter un log d'intégration

1. Allez sur le menu Administration > Intégration > Log d'intégration.

2. Cliquez sur le fichier de log.
Le détail du fichier est affiché.

3. Affichez la liste des enregistrements mis à jour dans chaque table du connecteur utilisé par le modèle d'intégration, via les liens hypertextes Ajoutés / Modifiés de l'onglet Enregistrements.

4. Consultez les erreurs d'intégration via l'onglet Erreurs.

Best Practice icon.png  Si les erreurs sont trop nombreuses, reprenez le backup de la base Service Manager, corrigez la source de données et relancez l'intégration.

Comment purger les logs d'intégration

     Open url.png voir Procédure détaillée : Comment créer une purge

Étape 1 : Saisie du délai de rétention pour la purge des logs d'intégration

1. Allez sur l'écran Administration > Paramétrages > Paramètres divers.

2. Spécifiez le nombre de jours au-delà duquel les logs d'intégration doivent être automatiquement supprimés, via le paramètre {ADMIN} Supprimer les logs d'intégration "Plus anciens que".
 

Étape 2 : Création de la nouvelle purge

1. Allez sur l'écran Administration > Purge > Purge des archives.

2. Cliquez sur + Nouveau.
 

Étape 3 : Saisie des informations de la purge

1. Renseignez les informations de la purge, puis cliquez sur Suivant.

  • Donnez un nom à la purge.

    exemple  Suppression des logs d'intégration

  • Sélectionnez la requête parent Log d'intégration.

2. Cochez les champs à afficher dans le fichier .csv généré par la purge, puis cliquez sur Suivant.

3. Renseignez la périodicité de la purge, puis cliquez sur Suivant.

Best Practice icon.png  

  • Avant de passer à l'étape suivante, testez la purge via Test pour vérifier le nombre d'enregistrements qui vont être supprimés.
  • Saisissez une date antérieure à la date du jour pour exécuter immédiatement la purge après sauvegarde de la tâche planifiée.

4. (optionnel) Renseignez les destinataires de l'e-mail de notification, puis cliquez sur Suivant.

5. Cliquez sur Terminer.

La purge est fonctionnelle. Les logs d'intégration vont être supprimés automatiquement en fonction du délai de rétention fixé dans les paramètres divers.

Les assistants

Vider tous les logs d'intégration

Tags :
Powered by XWiki © EasyVista 2022