GSLog : dans le champ d’application, global

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 4 minutes de lecture

    • GSLog est un include de script qui simplifie la journalisation et le débogage des scripts en implémentant des niveaux de sortie de journal, sélectionnables par valeur de sys_properties identifiées par appelant.

    Les journaux générés à l’aide de l’API GSLog sont enregistrés dans les journaux système. Plus précisément, vous pouvez trouver les journaux système dans l’interface utilisateur en accédant à Tous > Journaux système > Journal système. Vous pouvez choisir d’afficher tous les journaux ou des types de journaux spécifiques tels que les journaux d’application, les erreurs, les instructions de journal de script, etc. sous cet élément de menu. Le filtrage de la colonne Source dans la vue Tous les journaux peut vous aider à localiser vos entrées plus rapidement.

    Les journaux peuvent être au niveau du débogage, de l’information, de l’avis, de l’avertissement, de l’erreur ou de la critique (après BSD syslog.h et les suiveurs). Le niveau de journalisation par défaut est notice, les niveaux doivent donc être choisis en conséquence.

    À utiliser pour tout script côté serveur dans lequel vous souhaitez implémenter la journalisation des événements.

    Pour plus d’informations, voir Débogage de scripts.

    GSLog – GSLog()

    Instancie un objet GSLog .

    Tableau 1. Paramètres
    Nom Type Description
    traceProperty Chaîne Propriété système qui contient une valeur indiquant le niveau au-dessus duquel les messages seront écrits dans le journal.
    appelant Chaîne Nom du script appelant l’enregistreur. 
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA");

    GSLog – debugOn()

    Détermine si le débogage est activé.

    Tableau 2. Paramètres
    Nom Type Description
    Aucun
    Tableau 3. Renvoie
    Type Description
    Booléen

    Marqueur indiquant si le débogage est activé ou désactivé.

    Valeurs valides :
    • vrai : le débogage est activé.
    • faux : le débogage est désactivé.
    		 
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
gl.setLevel("debug");
gs.print(gl.debugOn());

    Sortie :

    *** Script : true

    GSLog – getLevel(niveau de chaîne)

    Renvoie le niveau de journal.

    Tableau 4. Paramètres
    Nom Type Description
    niveau Chaîne Facultatif. Niveau de journal.
    Tableau 5. Renvoie
    Type Description
    Chaîne Niveau de journal. 
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
gl.setLevel("debug");
gs.print(gl.getLevel());

    Sortie :

    *** Script: debug

    GSLog – initialize(String traceProperty, String caller)

    Appelé par le cadre de travail JavaScript prototype lors de la création d’un objet pour initialiser une nouvelle instance de cette classe. Fournissez les paramètres d’entrée, mais n’appelez pas cette méthode directement.

    Tableau 6. Paramètres
    Nom Type Description
    traceProperty Chaîne Propriété système qui contient une valeur indiquant le niveau au-dessus duquel les messages seront écrits dans le journal.
    appelant Chaîne Nom du script appelant l’enregistreur.
    Tableau 7. Renvoie
    Type Description
    Aucun 
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA");

    GSLog – log (niveau chaîne, message de chaîne)

    Consigne un message au niveau spécifié.

    Tableau 8. Paramètres
    Nom Type Description
    niveau Chaîne Niveau de journal.
    msg Chaîne Message à écrire dans le journal.
    Tableau 9. Renvoie
    Type Description
    Aucun 
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
gl.log("debug", "debug message");

    GSLog – logAlert(String msg)

    Consigne les événements d’alerte.

    Tableau 10. Paramètres
    Nom Type Description
    msg Chaîne Message à écrire dans le journal.
    Tableau 11. Renvoie
    Type Description
    Aucun 
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
gl.logAlert("This is an alert");

    Sortie :

    *** Script [TaskSLA]: This is an alert

    GSLog – logCrit(message de chaîne)

    Consigne les événements critiques.

    Tableau 12. Paramètres
    Nom Type Description
    msg Chaîne Message à écrire dans le journal.
    Tableau 13. Renvoie
    Type Description
    Aucun 
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
gl.logCrit("This is a critical message");

    Sortie :

    *** Script [TaskSLA]: This is a critical message

    GSLog – logDebug(message de chaîne)

    Consigne les événements de débogage.

    Tableau 14. Paramètres
    Nom Type Description
    msg Chaîne Message à écrire dans le journal.
    Tableau 15. Renvoie
    Type Description
    Aucun 
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
gl.logDebug("This is a debug message");

    Sortie :

    *** Script [TaskSLA]: This is a debug message

    GSLog – logEmerg(String msg)

    Consigne les événements d’urgence.

    Tableau 16. Paramètres
    Nom Type Description
    msg Chaîne Message à écrire dans le journal.
    Tableau 17. Renvoie
    Type Description
    Aucun 
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
gl.logEmerg("This is an emergency message");

    Sortie :

    *** Script  [TaskSLA ] : This is an emergency message

    GSLog – logErr(message de chaîne)

    Consigne les événements d’erreur.

    Tableau 18. Paramètres
    Nom Type Description
    msg Chaîne Message à écrire dans le journal.
    Tableau 19. Renvoie
    Type Description
    Aucun 
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
gl.logErr("This is an error message");

    Sortie :

    *** Script [TaskSLA]: This is an error message

    GSLog : logInfo(message de chaîne)

    Consigne les événements d’informations.

    Tableau 20. Paramètres
    Nom Type Description
    msg Chaîne Message à écrire dans le journal.
    Tableau 21. Renvoie
    Type Description
    Aucun 
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
gl.logInfo("This is an info message");

    GSLog – logNotice(message de chaîne)

    Consigne les événements de remarque.

    Tableau 22. Paramètres
    Nom Type Description
    msg Chaîne Message à écrire dans le journal.
    Tableau 23. Renvoie
    Type Description
    Aucun 
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
gl.logNotice("This is a notice");

    Sortie :

    *** Script [TaskSLA]: This is a notice

    GSLog : logWarning(message de chaîne)

    Consigne les événements d’avertissement.

    Tableau 24. Paramètres
    Nom Type Description
    msg Chaîne Message à écrire dans le journal.
    Tableau 25. Renvoie
    Type Description
    Aucun 
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
gl.logWarning("This is a warning message");

    Sortie :

    *** Script [TaskSLA]: This is a warning message

    GSLog – setLevel(niveau de chaîne)

    Définit le niveau de journalisation.

    Tableau 26. Paramètres
    Nom Type Description
    niveau Chaîne Niveau de journal à définir.
    Tableau 27. Renvoie
    Type Description
    Aucun 
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
gl.setLevel("debug");