GSLog: Bereichsbezogen, global

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer
  • GSLog ist eine Skripteinbindung, die die Skriptprotokollierung und das Debugging durch die Implementierung von Protokollausgabeebenen vereinfacht, die durch pro Anrufer identifizierte sys_properties-Werte ausgewählt werden können.

    Protokolle, die mit der GSLog -API generiert wurden, werden in den Systemprotokollen protokolliert. Insbesondere können Sie in der Anwenderoberfläche Systemprotokolle finden, indem Sie zu navigieren Alle > Systemprotokolle > Systemprotokoll. Unter diesem Menüelement können Sie alle Protokolle oder bestimmte Protokolltypen wie Anwendungsprotokolle, Fehler, Skriptprotokollanweisungen usw. anzeigen. Durch Filtern der Spalte „Quelle“ in der Ansicht „Alle Protokolle“ finden Sie Ihre Einträge schneller.

    Protokolle können sich auf der Ebene „Debug“, „Info“, „Hinweis“, „Warnung“, „Err“ oder „Krit“ (nach BSD „syslog.h“ und „Follower“) befinden. Die Standardprotokollierungsebene ist „Notiz“, daher sollten die Ebenen entsprechend ausgewählt werden.

    Verwenden Sie das Skript für jedes serverseitige Skript, in dem Sie die Event-Protokollierung implementieren möchten.

    Weitere Informationen finden Sie unter Debugging-Skripts.

    GSLog – GSLog()

    Instanziiert ein GSLog -Objekt.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    traceProperty Zeichenfolge Systemeigenschaft mit einem Wert, der die Ebene angibt, auf bzw. über der Meldungen in das Protokoll geschrieben werden.
    caller Zeichenfolge Name des Skripts, das die Protokollierung aufruft
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA");

    GSLog – debugOn()

    Bestimmt, ob Debugging aktiviert ist.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 3. Ergebnisse
    Typ Beschreibung
    Boolean

    Kennzeichnung, die angibt, ob Debuggen aktiviert oder deaktiviert ist.

    Gültige Werte:
    • „wahr“: Debuggen ist aktiviert.
    • „falsch“: Debuggen ist deaktiviert.
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.setLevel("debug");
    gs.print(gl.debugOn());

    Ausgabe:

    *** Script : true

    GSLog – getLevel(String level)

    Gibt die Protokollebene zurück.

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    level Zeichenfolge Optional. Protokollebene
    Tabelle : 5. Rückgaben
    Typ Beschreibung
    Zeichenfolge Protokollebene
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.setLevel("debug");
    gs.print(gl.getLevel());

    Ausgabe:

    *** Script: debug

    GSLog – initialize(String TraceProperty, String Caller)

    Wird vom Prototype JavaScript Framework während der Objekterstellung aufgerufen, um eine neue Instanz dieser Klasse zu initialisieren. Geben Sie die Eingabeparameter an, rufen Sie diese Methode jedoch nicht direkt auf.

    Tabelle : 6. Parameter
    Name Typ Beschreibung
    traceProperty Zeichenfolge Systemeigenschaft mit einem Wert, der die Ebene angibt, auf bzw. über der Meldungen in das Protokoll geschrieben werden.
    caller Zeichenfolge Name des Skripts, das die Protokollierung aufruft
    Tabelle : 7. Ergebnisse
    Typ Beschreibung
    Keine
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA");
    

    GSLog – Protokoll (Zeichenfolgenebene, Zeichenfolgennachricht)

    Protokolliert eine Meldung auf der angegebenen Ebene.

    Tabelle : 8. Parameter
    Name Typ Beschreibung
    level Zeichenfolge Protokollebene
    msg Zeichenfolge Nachricht, die in das Protokoll geschrieben werden soll.
    Tabelle : 9. Ergebnisse
    Typ Beschreibung
    Keine
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.log("debug", "debug message");

    GSLog – logAlert(String msg)

    Protokolliert Warnungs-Events.

    Tabelle : 10. Parameter
    Name Typ Beschreibung
    msg Zeichenfolge Nachricht, die in das Protokoll geschrieben werden soll.
    Tabelle : 11. Ergebnisse
    Typ Beschreibung
    Keine
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logAlert("This is an alert");

    Ausgabe:

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

    GSLog – logCrit(String msg)

    Protokolliert kritische Events.

    Tabelle : 12. Parameter
    Name Typ Beschreibung
    msg Zeichenfolge Nachricht, die in das Protokoll geschrieben werden soll.
    Tabelle : 13. Ergebnisse
    Typ Beschreibung
    Keine
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logCrit("This is a critical message");

    Ausgabe:

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

    GSLog – logDebug(String msg)

    Protokolliert Debug-Events.

    Tabelle : 14. Parameter
    Name Typ Beschreibung
    msg Zeichenfolge Nachricht, die in das Protokoll geschrieben werden soll.
    Tabelle : 15. Ergebnisse
    Typ Beschreibung
    Keine
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logDebug("This is a debug message");

    Ausgabe:

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

    GSLog – logEmerg(String msg)

    Protokolliert Notfall-Events.

    Tabelle : 16. Parameter
    Name Typ Beschreibung
    msg Zeichenfolge Nachricht, die in das Protokoll geschrieben werden soll.
    Tabelle : 17. Ergebnisse
    Typ Beschreibung
    Keine
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logEmerg("This is an emergency message");

    Ausgabe:

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

    GSLog – logErr(String msg)

    Protokolliert Fehler-Events.

    Tabelle : 18. Parameter
    Name Typ Beschreibung
    msg Zeichenfolge Nachricht, die in das Protokoll geschrieben werden soll.
    Tabelle : 19. Ergebnisse
    Typ Beschreibung
    Keine
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logErr("This is an error message");

    Ausgabe:

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

    GSLog – logInfo(String msg)

    Protokolliert Informations-Events.

    Tabelle : 20. Parameter
    Name Typ Beschreibung
    msg Zeichenfolge Nachricht, die in das Protokoll geschrieben werden soll.
    Tabelle : 21. Rückgaben
    Typ Beschreibung
    Keine
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logInfo("This is an info message");

    GSLog – logNotice(String msg)

    Protokolliert Hinweis-Events.

    Tabelle : 22. Parameter
    Name Typ Beschreibung
    msg Zeichenfolge Nachricht, die in das Protokoll geschrieben werden soll.
    Tabelle : 23. Ergebnisse
    Typ Beschreibung
    Keine
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logNotice("This is a notice");

    Ausgabe:

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

    GSLog – logWarning(String msg)

    Protokolliert Warnungs-Events.

    Tabelle : 24. Parameter
    Name Typ Beschreibung
    msg Zeichenfolge Nachricht, die in das Protokoll geschrieben werden soll.
    Tabelle : 25. Ergebnisse
    Typ Beschreibung
    Keine
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logWarning("This is a warning message");

    Ausgabe:

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

    GSLog – setLevel(String level)

    Legt die Protokollebene fest.

    Tabelle : 26. Parameter
    Name Typ Beschreibung
    level Zeichenfolge Festzulegende Protokollebene.
    Tabelle : 27. Rückgaben
    Typ Beschreibung
    Keine
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.setLevel("debug");