Logify - Library for log management - bibliothèque pour MetaTrader 5

Installation

1. Copiez le dossier /Logify dans :
   

   MQL5/Include/

2. Incluez Logify dans votre EA, indicateur ou script :
   

   #include <Logify/Logify.mqh>

3. Il est possible d'installer en utilisant Git, il suffit d'accéder au dépôt et de suivre les étapes.

🔧 Exemple de démarrage rapide

Exemple simple avec les paramètres par défaut :

//+------------------------------------------------------------------+
//| Importation|
//+------------------------------------------------------------------+
#include <Logify/Logify.mqh>
CLogify Logify;
//+------------------------------------------------------------------+
//| Fonction d'initialisation de l'expert|
//+------------------------------------------------------------------+
int OnInit()
  {
   //--- Exemple de journaux
   Logify.Debug("Initialization started");
   Logify.Info("Account balance is OK");
   Logify.Alert("Take profit reached");
   Logify.Error("Failed to send order", "Order", "Reason: No money");
   Logify.Fatal("Critical error: Invalid input parameters");

  //---
   return(INIT_SUCCEEDED);
  }
//+------------------------------------------------------------------+

Exemple avancé, avec des paramètres de handler personnalisés. Dans cet exemple, nous sauvegardons l'enregistrement du journal dans des fichiers et dans le commentaire du graphique. Personnalisation des paramètres pour chacun d'entre eux.

//+------------------------------------------------------------------+
//| Importation|
//+------------------------------------------------------------------+
#include <Logify/Logify.mqh>
CLogify Logify;
//+------------------------------------------------------------------+
//| Fonction d'initialisation de l'expert|
//+------------------------------------------------------------------+
int OnInit()
  {
   //--- Configurer le gestionnaire de commentaires
   MqlLogifyHandleCommentConfig config_comment;
   config_comment.size = 10;
   config_comment.frame_style = LOG_FRAME_STYLE_SINGLE;
   config_comment.direction = LOG_DIRECTION_UP;
   config_comment.title = "My Expert";

   //--- Créer et configurer le gestionnaire de commentaires
   CLogifyHandlerComment *handler_comment = new CLogifyHandlerComment();
   handler_comment.SetConfig(config_comment);
   handler_comment.SetLevel(LOG_LEVEL_DEBUG);
   handler_comment.SetFormatter(new CLogifyFormatter("{date_time} [{levelname}]: {msg}","hh:mm:ss"));
   
   //--- Configurer le gestionnaire de fichiers
   MqlLogifyHandleFileConfig file_config;
   file_config.CreateDateRotationConfig("my_expert","logs",LOG_FILE_EXTENSION_LOG,10,100,CP_UTF8);
   
   //--- Créer et configurer le gestionnaire de fichiers
   CLogifyHandlerFile *handler_file = new CLogifyHandlerFile();
   handler_file.SetConfig(file_config);
   handler_file.SetLevel(LOG_LEVEL_DEBUG);
   handler_file.SetFormatter(new CLogifyFormatter("{date_time} [{levelname}]: {msg} ({filename} | {origin} | {function})","hh:mm:ss"));
   
   //--- Attacher le gestionnaire
   Logify.AddHandler(handler_comment);
   Logify.AddHandler(handler_file);

   //--- Exemple de journaux
   Logify.Debug("Initialization started");
   Logify.Info("Account balance is OK");
   Logify.Alert("Take profit reached");
   Logify.Error("Failed to send order", "Order", "Reason: No money");
   Logify.Fatal("Critical error: Invalid input parameters");
   
   //---
   return(INIT_SUCCEEDED);
  }
//+------------------------------------------------------------------+

Pour comprendre chacun des paramètres, je vous recommande de lire les articles ci-dessous, dans lesquels j'explique chaque étape du développement de la bibliothèque :

• Maîtriser les enregistrements de journaux (Partie 1) : Concepts fondamentaux et premiers pas dans MQL5
• Maîtriser les enregistrements de journaux (Partie 2) : Formatage des journaux
• Maîtriser les enregistrements de logs (Partie 3) : Explorer les gestionnaires pour sauvegarder les journaux
• Maîtriser les enregistrements de logs (Partie 4) : Sauvegarde des journaux dans des fichiers
• Maîtriser les enregistrements de logs (Partie 5) : Optimiser le gestionnaire avec le cache et la rotation
• Maîtriser les enregistrements de journaux (Partie 6) : Sauvegarde des logs dans la base de données
• Maîtriser les enregistrements de journaux (Partie 7) : Comment afficher les journaux sur un graphique
• Maîtriser les enregistrements de journaux (Partie 8) : Les enregistrements d'erreurs qui se traduisent eux-mêmes
• Maîtriser les enregistrements de logs (Partie 9) : Implémenter le modèle de construction et ajouter des configurations par défaut
• Maîtriser les enregistrements de logs (Partie 10) : Éviter la relecture des journaux en implémentant une suppression