ONYX - 9.1 - Utilisation

Gestion des logs AMETHYST

De MappingDoc
Révision datée du 18 septembre 2019 à 13:40 par Jdieu (discussion | contributions)

Préambule

Par défaut les logs générées par Mapping sont dans un format propriétaire Mapping afin que celles-ci puissent être lu par l'interface de MAPPING. Il est possible de les transformer en texte grâce à la commande map_log_txt mais il est impossible de modifier leur formatage. Grâce à Améthyst, il est possible de générer des logs avec un formatage paramétrable et vers différents médias possibles.

Limitations

Améthyst est en constance évolution. La sortie 9.1.0 inclus la possibilité d'utiliser Améthyst uniquement pour les exécutions du workflow. (Binaire map_809) Des évolutions permettront l'utilisation d'Améthyst avec d'autres binaires. (mapcpysplf, map_lpr et autres)

Liste des médias possibles

Les médias de sorties de logs sont :

  • Fichier texte
  • La console invoquant le traitement
  • Une requête HTTP

Prérequis

  • Onyx Server v9.1.0 minimum

Paramétrage

Pour activer les logs Amethyst il faudra procéder à des modifications

mapping.conf

  1. Aller dans le bloc LOGS
  2. Ajouter les paramètres suivants
  • LOG_TYPE
    • Default : Utilisation de l'ancien système de log Mapping
    • Amethyst : Utilisation du nouveau système de log Mapping (Améthyst)
    • Both : Utilisation des deux systèmes de logs (Ancien et Améthyst)
  • PATH_AMETHYST_LOG
    • Chemin du fichier de configuration d'Améthyst

config.yaml

Améthyst a besoin d'un fichier de configuration, qui part défaut, s'appelle config.yaml et se situe dans le répertoire conf ou settings de MAPPING. Son nom et chemin sont spécifiés dans le fichier mapping.conf dans la partie LOGS avec le paramètre PATH_AMETHYST_LOG Ce fichier de configuration est au format yaml