Paramètres de journalisation
FlowForce Server offre un mécanisme de journalisation afin d'enregistrer tous les types d'événements et l'heure à laquelle ils se sont produits (comme les événements de résultat de tâche, les événements de modification de configuration, les erreurs, etc.). Vous pouvez consulter tous les événements de journal dans une page séparée, voir Consulter le journal de tâche. Veuillez noter que les événements de journal, au fil du temps, peuvent augmenter considérablement la taille de la base de données interne de FlowForce Server. C'est pourquoi le journal doit être archivé périodiquement ou nettoyé en utilisant les fonctions archive-log ou truncate-log /system/maintenance. FlowForce peut effectuer deux types de journalisation :
Un journalisation dans FlowForceServer peut se faire de deux manières :
1.Une journalisation du système par défaut qui ne requiert pas d’intervention manuelle de tout genre. Ce genre de journalisation est pris en charge par le système et enregistre tous les événements, mais maintient la taille de chaque enregistrement de journal à une certaine limite, pour une meilleure stabilité et performance. Si la journalisation de système ne fournit pas suffisamment de niveaux de détails, ou si vous trouvez que les entrées de journal (comme des valeurs de paramètres dans les étapes) sont coupées parce qu'elles sont trop longues, vous pouvez utiliser une journalisation explicite, voir ci-dessous.
2.Journalisation optionnelle (explicite) que vous pouvez appliquer depuis la page de configuration de la tâche. La page de configuration de la tâche propose une touche Journal 
que vous pouvez activer en option à côté de chaque paramètre que vous souhaitez suivre dans le journal. Cela vous permettra d'effectuer un log de la valeur complète de ce paramètre lorsque la tâche est exécutée. De plus, vous pouvez intégrer tout expression FlowForce à l'intérieur de la fonction d'expression log pour pouvoir requêter que cette expression soit enregistrée explicitement. De nouveau, l'expression sera enregistrée complètement et sa valeur ne sera pas coupée. FlowForce Server ne limite pas la taille des entrées enregistrées en tant que résultat d'une journalisation explicite.
Limites de journalisation
Si vous ne souhaitez pas utiliser la journalisation explicite pour une raison quelconque, vous pouvez également modifier la taille par défaut des entrées de journal entretenues par le système.
Le fait de modifier la taille par défaut du journal à une valeur plus importante peut avoir des conséquences sur la stabilité du système et sa performance, Veuillez donc utiliser cette option avec précaution. L'approche recommandée est d'utiliser la journalisation explicite, comme indiqué ci-dessus. |
Pour modifier la taille par défaut des entrées de journal
1.Se connecter à l'interface d'administration FlowForce Web.
2.Allez à Administration | Paramètres et observez les paramètres groupés sous « Limites de journalisation ».
Veuillez noter qu'il y a deux types d'entrées enregistrées : les types string et les types list. Par conséquent, il existe deux paramètres permettant de contrôler la taille de chaque type.
Limite de journalisation de la valeur string par défaut | Spécifie la longueur par défaut des entrées de journal qui sont de type "string". Si une entrée de journal dépasse cette valeur, des valeurs arbitraires très longues comme des chemins de fichier seront coupés. |
Limite de journalisation de la valeur de liste par défaut | Idem à ci-dessus, s'applique à des entrées de type "list". |
Récurser dans des sous-listes | Ce paramètre touche des tâches qui opèrent sur des listes qui contiennent d'autres listes en tant qu'enfants. Définir cette valeur pour indiquer à FlowForce de chercher N niveaux en profondeurs à des fins de journalisation. |
Journalisation d'instance
Les paramètres dans la section « Journalisation d’instance » affectent le niveau d’information rapporté à la page de journalisation d’instance.
Les messages journalisés peuvent avoir plusieurs niveaux de sévérité, du niveau le plus bas au niveau le plus élevé : information, avertissement, erreur. Les paramètres de "Journalisation d'instance" permettent d'ignorer la journalisation de certains messages selon leur sévérité. Vous pouvez aussi configurer la quantité d'information de traçage qui doit être stockée par FlowForce Server, et vous pouvez aussi complètement désactiver la rétention des journaux. L'image ci-dessous illustre les paramètres par défaut :
Si vous décochez la case Retenir journal aucune information ne sera rapportée dans la page Journal d'instance.
L'option Sévérité des messages spécifie quels messages retenir :
Aucun | Aucun message n'est conservé |
Erreur | Garder les messages d'erreurs et les messages importants |
Warning | Garder les messages d'erreurs, les messages importants et les avertissements |
Information | Garder les messages d'erreurs, les messages importants, les avertissements et les messages d'information |
Tout | Il s'agit de l'option la plus verbeuse. Tous les messages sont conservés, quelque soit leur sévérité. |
Le paramètre Trace d'exécution spécifie la quantité de détail de traçage à conserver :
Aucun | Aucune information de traçage n'est conservée |
Flux | Garder les streams mais exclut les traces |
Tracer | Garder les traces mais exclut les streams |
Complet | Garder tous les niveaux possible d'information de traçage. |
Règles
Les paramètres "Journalisation d'instance" décrits ci-dessus constituent une "règle". Vous pouvez créer des règles personnalisées, en plus de la règle par défaut, en cliquant sur la touche 
. Cela permet d'appliquer des règles conditionnellement, sur la base du résultat de la tâche, qui peut être une des suivantes :
Exécution réussie | La tâche est considérée réussie. |
Exécution échouée | L'exécution de la tâche a échoué. |
Interruption par l'utilisateur | La tâche a été arrêtée par l’action de l’utilisateur, voir Arrêter tâches. |
Interrompu | Le service a été arrêté avant que la tâche ne puisse être terminée, ou que FlowForce Server crash, ou que la connexion à l’instance du travailleur a été perdue (dans une configuration clustered ). |
Les règles définies dans cette page sont évaluées du haut en bas. Si le résultat de la tâche correspond à un des résultats recensés ci-dessus, la règle reçoit une correspondance. La première règle de correspondance gagne.
Par exemple, la configuration illustrée ci-dessous préserve tout le journal du message si l’exécution de la tâche n’a pas réussie. Autrement dit, la première règle sera déclenchée si le résultat est "Exécution échouée" ou "Interruption par l'utilisateur" or "Interrompu". Sur une exécution réussie, la règle par « défaut » sera déclenchée à la place, et, même si les messages de journal seront gardés, aucune information de traçage ne sera disponible.
Veuillez noter que vous pouvez ajouter toutes les règles personnalisées uniquement avant la règle par défaut, pas après. Pour modifier l’ordre des règles, utilisez les boutons Up 
et Down 
. Ces touches sont uniquement activées lorsqu'il y a trois règles ou plus.
Si vous définissez des règles personnalisées, il est conseillé d'utiliser la règle par défaut en tant que filtre "fourre-tout", dans le cas où aucune des règles situées avant n'ait obtenu de correspondance.
Règles de journalisation au niveau de l'objet
Vous pouvez créer des règles de journalisation non seulement globalement au niveau de l'application, mais aussi pour des tâches FlowForce Server spécifiques. Notez que si vous créez une règle sur une tâche qui a des sous-tâches, ensuite la règle s'appliquera à toutes les sous-tâches également.
Pour définir les règles de journalisation pour une tâche :
1.Ouvrir la page de configuration de la tâche.
2.Cliquer sur la touche Paramètres de journalisation dans la page de configuration de la tâche.
3.Cliquer sur Nouvelle règle de journalisation d'instance.
Pour définir les règles de journalisation de plusieurs tâches :
1.Cliquer sur Configuration et ouvrir un conteneur.
2.Choisir une ou plusieurs tâches (ou le conteneur entier), puis cliquer sur Paramètres de journalisation pour les tâches sélectionnées. Un dialogue apparaît dans lequel vous pouvez préciser la sélection le cas échéant :
3.Cliquer sur Modifier paramètres de journalisation.
4.Cliquer sur Nouvelle règle de journalisation d'instance.
Tous les paramètres de journalisation fonctionnent comme dans la description ci-dessus dans la section "Règles".
Si vous avez défini des règles de journalisation aussi bien au niveau de l'objet qu'au niveau de l'application, alors la priorité est établie comme suit :
•Les règles de journalisation définies au niveau de l'objet sont vérifiées en premier. •Si une correspondance est trouvée à ce niveau, la règle est appliquée et les règles au niveau de l'application ne sont plus vérifiées. •Si aucune correspondance n'est trouvée à ce niveau, les règles au niveau d'application sont vérifiées. |