> For the complete documentation index, see [llms.txt](https://ksaar.gitbook.io/ksaar-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ksaar.gitbook.io/ksaar-documentation/aller-plus-loin/suivi-des-executions.md).

# 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="/files/fGfpeAjZf0DzOUmpXkJA" 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="/files/wO7g9YgSdhkU6X47c6m6" 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="/files/7WmRndiPWiBeHu8I9jv7" 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ksaar.gitbook.io/ksaar-documentation/aller-plus-loin/suivi-des-executions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.