Jobs¶
Présentation¶
Le module Jobs permet de visualiser les jobs en cours et terminés, d'arrêter les relances de jobs bloqués en cas d'indisponibilité du serveur, et de modifier et relancer les jobs de vérification de statut de ticket en cas d'erreur de configuration.
Ce module est accessible via le menu Administration → Jobs.
Vue d'ensemble¶
La page Jobs est organisée en quatre onglets :
| Onglet | Description |
|---|---|
| Instructions | Jobs liés aux instructions de remédiation |
| Webhooks | Jobs liés aux webhooks (règles de déclaration de ticket et scénarios) |
| Statut des tickets | Jobs de vérification périodique du statut des tickets |
| Auth token | Jobs de renouvellement des jetons d'authentification |
Note
Les jobs en statuts internes (triggered, skipped, waiting) ne sont pas affichés dans ces listes. Par exemple, lorsqu'une règle de déclaration de ticket s'exécute, Canopsis crée des jobs pour tous les webhooks, mais si l'option "Arrêter en cas d'échec" est activée, les webhooks suivants ne sont pas exécutés après un échec et n'apparaissent pas ici.
Colonnes des tableaux¶
Onglet Instructions¶
| Colonne | Description |
|---|---|
| Nom de la règle | Nom de la règle au moment de la création du job |
| Statut | Statut du job |
| Date de début | Date et heure de démarrage du job |
| Date de fin | Renseignée uniquement pour les jobs dont le statut est différent de "En cours" |
| Raison de l'échec | Renseignée uniquement pour les jobs avec le statut "Échoué" |
| Actions | Actions disponibles |
Onglet Webhooks¶
Mêmes colonnes que l'onglet Instructions, avec en plus :
| Colonne | Description |
|---|---|
| Type de règle | Règle de déclaration de ticket ou Scénario |
Onglet Statut des tickets¶
| Colonne | Description |
|---|---|
| Nom de la règle | Nom de la règle au moment de la création du job |
| Type de règle | Type de règle associée |
| Nom du système de tickets | Affiché uniquement pour les règles de déclaration de ticket |
| Numéro de ticket | Numéro du ticket concerné |
| État actif | État de surveillance du ticket (voir États actifs) |
| Dernier statut | Dernier statut connu du ticket |
| Date de début | Date et heure de démarrage du job |
| Date de fin | Renseignée uniquement pour les jobs dont le statut est différent de "En cours" |
| Raison de l'échec | Renseignée uniquement pour les jobs avec le statut "Échoué" |
| Actions | Actions disponibles selon l'état actif |
Onglet Auth token¶
Mêmes colonnes que l'onglet Instructions, avec en plus :
| Colonne | Description |
|---|---|
| Date d'expiration | Renseignée uniquement pour les jobs avec le statut "Réussi" |
Note
Dans cet onglet, la colonne Nom de la règle est libellée Nom du jeton d'auth.
Statuts des jobs¶
Les statuts disponibles varient selon l'onglet :
| Statut | Instructions | Webhooks | Statut des tickets | Auth token |
|---|---|---|---|---|
| En cours | Oui | Oui | Non | Oui |
| Échoué | Oui | Oui | Oui | Oui |
| Interrompu | Oui | Non | Non | Non |
| Réussi | Oui | Oui | Oui | Oui |
États actifs (onglet Statut des tickets)¶
L'état actif décrit la situation de la surveillance périodique du ticket :
| État | Description |
|---|---|
| En cours | Surveillance active, les requêtes de vérification du statut sont envoyées normalement |
| En pause | Surveillance suspendue manuellement, les requêtes sont interrompues jusqu'à réactivation |
| Arrêté | Canopsis a reçu un changement de statut depuis une API externe et a arrêté la surveillance |
Comportement des jobs à l'état "Arrêté" :
- Les jobs arrêtés sont conservés jusqu'à la fin de leur durée.
- Les jobs ayant reçu un statut de fermeture sont supprimés.
- Les jobs dont la durée est expirée sont supprimés.
Détail d'un job¶
Chaque ligne du tableau peut être développée (accordéon) pour afficher la dernière requête et la dernière réponse HTTP.
- La Réponse est affichée par défaut.
- La Requête est masquée par défaut.
Note
Seule la dernière requête et la dernière réponse sont conservées. L'historique complet n'est pas stocké.
Recherche et filtres¶
Onglet Instructions¶
- Rechercher par nom de règle
- Filtrer par statut
Onglet Webhooks¶
- Rechercher par nom de règle
- Filtrer par type de règle
- Filtrer par statut
Onglet Statut des tickets¶
- Rechercher par nom de règle, nom du système de tickets ou numéro de ticket
- Filtrer par dernier statut
- Filtrer par état actif
Onglet Auth token¶
- Rechercher par nom du jeton d'auth
- Filtrer par statut
Tri par défaut¶
Instructions¶
Tri par statut : En cours, Échoué, Interrompu, Réussi.
Webhooks¶
Tri par statut : En cours, Échoué, Réussi.
Statut des tickets¶
Tri par état actif (En cours, En pause), puis par statut (Échoué, Réussi).
Auth token¶
Tri par statut : En cours, Échoué, Réussi.
Actions¶
Instructions, Webhooks et Auth token¶
| Action | Disponibilité | Effet |
|---|---|---|
| Arrêter le job | Jobs en cours uniquement | Arrête le job, statut changé en "Interrompu". Un job interrompu ne peut pas être relancé. |
Statut des tickets (état actif : En cours)¶
| Action | Effet |
|---|---|
| Modifier le job | Ouvre la modale de modification (voir Modifier un job) |
| Répéter le job | Lance le job manuellement avant la prochaine échéance planifiée |
| Mettre le job en pause | Suspend la surveillance jusqu'à réactivation manuelle |
Statut des tickets (état actif : En pause)¶
| Action | Effet |
|---|---|
| Modifier le job | Ouvre la modale de modification |
| Démarrer le job | Réactive la surveillance et relance les requêtes de vérification |
Statut des tickets (état actif : Arrêté)¶
Aucune action disponible.
Actions groupées¶
La case à cocher "Sélectionner tout" n'est pas disponible, car les jobs d'un même tableau peuvent avoir des statuts et des actions différents.
Instructions, Webhooks, Auth token¶
| Action | Disponibilité |
|---|---|
| Arrêter les jobs | Disponible uniquement pour les jobs en cours. Les cases des autres jobs sont désactivées. |
Statut des tickets¶
Dès qu'un job est sélectionné, les cases des jobs ayant un état actif différent sont désactivées.
| État actif | Actions groupées disponibles |
|---|---|
| En cours | Mettre en pause, Répéter |
| En pause | Démarrer |
Notifications¶
Un bandeau de notification s'affiche après chaque action :
| Action | Message |
|---|---|
| Répéter (unitaire) | Job pour **{nom de la règle}** / **Numéro de ticket {numéro}** répété |
| Répéter (groupé) | {N} jobs répétés |
| Mettre en pause (unitaire) | Job pour **{nom de la règle}** / **Numéro de ticket {numéro}** mis en pause |
| Mettre en pause (groupé) | {N} jobs mis en pause |
| Démarrer (unitaire) | Job pour **{nom de la règle}** / **Numéro de ticket {numéro}** redémarré |
| Démarrer (groupé) | {N} jobs redémarrés |
| Arrêter | Job pour **{nom de la règle}** arrêté |
| Job mis à jour | Job mis à jour |
En cas d'échec d'une action groupée, un message d'erreur précise le nombre de jobs concernés.
Modifier un job¶
La modification est disponible uniquement pour les jobs de l'onglet Statut des tickets.
La modale affiche les champs suivants :
Informations en lecture seule¶
| Champ | Description |
|---|---|
| Type de règle | Type de règle associée |
| Nom de la règle | Nom au moment de la création du job. Une info-bulle indique que ce nom correspond à la règle au moment de la création. |
| Nom du système de tickets | Système de tickets ciblé |
| Ticket | Numéro du ticket (modifiable) |
Vérification du statut du ticket¶
| Champ | Obligatoire | Description |
|---|---|---|
| Méthode | Oui | Méthode HTTP (ex. POST) |
| URL | Oui | URL de l'API à interroger |
Paramètres de timeout¶
| Champ | Description |
|---|---|
| Durée | Durée avant expiration |
| Unité | Unité de temps |
Répétition¶
Les paramètres de répétition sont configurés dans le fichier TOML. Ils sont affichés à titre informatif uniquement.
Options¶
| Champ | Description |
|---|---|
| Ignorer la vérification du certificat HTTPs | Désactive la vérification SSL |
Authentification¶
Trois modes sont disponibles :
- Non requise
- Avec identifiants : saisie du nom d'utilisateur et du mot de passe
- Avec jeton
En-têtes¶
Permet d'ajouter des en-têtes HTTP personnalisés à la requête.
Payload¶
Corps de la requête envoyée à l'API.
Correspondance des statuts du ticket¶
| Champ | Description |
|---|---|
| Champ source du statut du ticket | Champ de la réponse de l'API contenant le statut |
| Correspondance des statuts | Association entre les valeurs de l'API externe et les statuts Canopsis. Au moins une valeur doit être mappée vers le statut « Fermé ». Toutes les valeurs sources non mappées sont associées au statut Canopsis « Inconnu ». |
Warning
Les templates Go ne sont pas disponibles dans ce formulaire.
Après enregistrement, la prochaine requête sera exécutée avec la configuration mise à jour.
Comportement de la période de vérification¶
- Si un job est mis en pause puis réactivé, la période de vérification n'est pas réinitialisée.
- Si un job est modifié, la période de vérification repart depuis le début.