# Suivi des exécutions

Lors de votre développement d'applications Ksaar il se peut que vous ayez besoin de suivre l'historique des exécutions d'un suivi, d'un workflow ou d'une automation. 

L'objectif de ce suivi des exécutions est de faciliter le débuggage et l'identification de problèmes au sein de votre application.

Le suivi des exécutions recense toutes les actions effectuées au sein d'un workflow, suivi ou automation. Dans une automation, ce suivi permet aussi de consulter la file d'attente.

{% hint style="info" %}
Les logs d’exécution sont conservés pendant 30 jours. Passé ce délai, ils sont automatiquement supprimés.
{% endhint %}

{% hint style="info" %}
Cette fonctionnalité est disponible à partir du plan [Enterprise](https://www.ksaar.com/pricing).
{% endhint %}

<figure><img src="https://2063331370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQBQ-Fk5qKATOA2R2_R%2Fuploads%2FoVlHFo5zWqkt8crQOCAi%2FCapture%20d%E2%80%99e%CC%81cran%202025-05-23%20a%CC%80%2015.08.12.png?alt=media&#x26;token=b68af3f3-8a29-47cb-ab63-0a896eb8f1c0" alt=""><figcaption><p>Onglet de suivi des exécutions pour une automation</p></figcaption></figure>

## ⏰ Historique des exécutions

L'onglet "Historique des exécutions" montre l’historique récent d’exécution des différentes étapes composant le scénario de l’automatisation, suivi ou workflow. Pour chaque étape, vous pouvez consulter ses informations :

* Date d'exécution
* Nom de l'étape (et indication de la présence dans une boucle ou non)
* État
* Identifiant de l'enregistrement sur lequel a été déclenché la tâche
* (si présence dans une boucle) Identifiant de l'enregistrement sur lequel l'étape a été déclenchée

L'objectif de cette fonctionnalité de suivi est de pouvoir :&#x20;

* Retracer le comportement de toutes les étapes effectuées dans votre application
* Simplifier le débuggage en examinant précisément quelles étapes font quelles actions
* Transmettre des informations précises au support Ksaar en cas de bug éventuel (notamment pour les identifiants d'enregistrement)

<figure><img src="https://2063331370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQBQ-Fk5qKATOA2R2_R%2Fuploads%2FZN2pJUlc0ITxaH71ObTi%2FCapture%20d%E2%80%99e%CC%81cran%202025-05-07%20a%CC%80%2016.23.31.png?alt=media&#x26;token=359a9402-44dc-4153-888a-b7503e52a4cb" alt=""><figcaption><p>Historique des exécutions d'une automation</p></figcaption></figure>

{% hint style="info" %}
Il est possible de filtrer le tableau en fonction de chacun des critères cités précédemment, ou en combinant certains critères.&#x20;
{% endhint %}

Vous pouvez aussi consulter plus de détails sur chaque étape au clic sur une ligne. Si l'étape s'est effectuée dans une boucle vous pouvez aussi consulter l'enregistrement qui a créé la boucle.

## ⏳ File d'attente (automations uniquement)

Dans ce menu, un tableau recense les différents événements déclencheurs en attente de traitement. En effet, toute étape est liée à un évènement déclencheur, donc seuls ceux-ci sont montrés.

L'onglet "File d’attente" montre un tableau avec la liste d’événements déclencheurs en attente de traitement. Pour chaque événement, vous pouvez consulter les informations suivantes :

* Date d'exécution
* État
* Nombre de tentatives
* Identifiant de l'enregistrement sur lequel a été déclenché la tâche
* Identifiant de l'évènement
  * cet identifiant est temporaire et assigné aux tâches en fonction de leur ordre de service
* Possibilité de supprimer l'évènement déclencheur

{% hint style="warning" %}
Si un évènement déclencheur est supprimé, les étapes associées ne seront pas exécutées.
{% endhint %}

L'objectif de cet onglet est de recenser clairement ce que va faire l'automation dans le futur. Il est donc possible de s'assurer du bon fonctionnement des mécanismes de votre application. Ainsi que le débuggage éventuel du déclenchement d'évènements.

<figure><img src="https://2063331370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQBQ-Fk5qKATOA2R2_R%2Fuploads%2Fs5Ixzu5EtZ7F2PquFIDF%2FCapture%20d%E2%80%99e%CC%81cran%202025-05-07%20a%CC%80%2016.41.12.png?alt=media&#x26;token=56a38a0e-3f6f-4853-95d4-428f3ae0a227" alt=""><figcaption><p>File d'attente des exécutions d'une automation</p></figcaption></figure>

Au clic sur chaque ligne, il est possible d’avoir plus de détails sur l’événement déclencheur.

Dans cet onglet il est possible de télécharger les données des exécutions à suivre du tableau en JSON pour faciliter leur traitement si besoin.