GSLog - スコープ指定、グローバル

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:6分
  • GSLog は、呼び出し元ごとに識別される sys_properties 値によって選択可能なログ出力のレベルを実装することで、スクリプトのログ記録とデバッグを簡素化するスクリプトインクルードです。

    GSLog API を使用して生成されたログは、システムログに記録されます。具体的には、UI でシステムログを見つけるには、 All (すべて) > システムログ > システムログ. このメニューアイテムでは、すべてのログを表示するか、アプリケーションログ、エラー、スクリプトログステートメントなどの特定のログタイプを表示するかを選択できます。[すべてのログ] ビューの [ソース] 列をフィルタリングすると、エントリをすばやく見つけることができます。

    ログは、debug、info、notice、warning、err、または crit のレベルを指定できます (BSD syslog.h 以降とフォロワー)。デフォルトのログ記録レベルは notice であるため、状況に応じてレベルを選択する必要があります。

    イベントログ記録を実装するサーバー側スクリプトに使用します。

    詳細については、「 スクリプトのデバッグ」を参照してください。

    GSLog – GSLog()

    GSLog オブジェクトをインスタンス化します。

    表 : 1. パラメーター
    名前 タイプ 説明
    traceProperty 文字列 ログに書き込まれるメッセージの最低レベルを示す値を含むシステムプロパティ。
    caller 文字列 ロガーを呼び出すスクリプトの名前。
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA");

    GSLog – debugOn()

    デバッグをオンにするかどうかを決定します。

    表 : 2. パラメーター
    名前 タイプ 説明
    なし
    表 : 3. 返される内容
    タイプ 説明
    ブーリアン

    デバッグがオンかオフかを示すフラグ。

    有効な値:
    • true:デバッグはオンです。
    • false:デバッグはオフです。
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.setLevel("debug");
    gs.print(gl.debugOn());

    出力:

    *** Script : true

    GSLog – getLevel(文字列 level)

    ログレベルを返します。

    表 : 4. パラメーター
    名前 タイプ 説明
    level 文字列 オプション。ログレベル。
    表 : 5. 返される内容
    タイプ 説明
    文字列 ログレベル。
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.setLevel("debug");
    gs.print(gl.getLevel());

    出力:

    *** Script: debug

    GSLog – initialize(文字列 traceProperty, 文字列 caller)

    オブジェクト構築中に Prototype JavaScript フレームワークによって呼び出され、このクラスの新しいインスタンスを初期化します。入力パラメーターを指定します。ただし、このメソッドを直接呼び出さないでください。

    表 : 6. パラメーター
    名前 タイプ 説明
    traceProperty 文字列 ログに書き込まれるメッセージの最低レベルを示す値を含むシステムプロパティ。
    caller 文字列 ロガーを呼び出すスクリプトの名前。
    表 : 7. 返される内容
    タイプ 説明
    なし
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA");
    

    GSLog – log(文字列 level, 文字列 msg)

    指定されたレベルでメッセージをログに記録します。

    表 : 8. パラメーター
    名前 タイプ 説明
    level 文字列 ログレベル。
    msg 文字列 ログに書き込むメッセージ。
    表 : 9. 返される内容
    タイプ 説明
    なし
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.log("debug", "debug message");

    GSLog – logAlert(文字列 msg)

    アラートイベントをログに記録します。

    表 : 10. パラメーター
    名前 タイプ 説明
    msg 文字列 ログに書き込むメッセージ。
    表 : 11. 返される内容
    タイプ 説明
    なし
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logAlert("This is an alert");

    出力:

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

    GSLog – logCrit(文字列 msg)

    重要なイベントをログに記録します。

    表 : 12. パラメーター
    名前 タイプ 説明
    msg 文字列 ログに書き込むメッセージ。
    表 : 13. 返される内容
    タイプ 説明
    なし
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logCrit("This is a critical message");

    出力:

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

    GSLog – logDebug(文字列 msg)

    デバッグイベントをログに記録します。

    表 : 14. パラメーター
    名前 タイプ 説明
    msg 文字列 ログに書き込むメッセージ。
    表 : 15. 返される内容
    タイプ 説明
    なし
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logDebug("This is a debug message");

    出力:

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

    GSLog – logEmerg(文字列 msg)

    緊急イベントをログに記録します。

    表 : 16. パラメーター
    名前 タイプ 説明
    msg 文字列 ログに書き込むメッセージ。
    表 : 17. 返される内容
    タイプ 説明
    なし
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logEmerg("This is an emergency message");

    出力:

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

    GSLog – logErr(文字列 msg)

    エラーイベントをログに記録します。

    表 : 18. パラメーター
    名前 タイプ 説明
    msg 文字列 ログに書き込むメッセージ。
    表 : 19. 返される内容
    タイプ 説明
    なし
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logErr("This is an error message");

    出力:

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

    GSLog – logInfo(文字列 msg)

    情報イベントをログに記録します。

    表 : 20. パラメーター
    名前 タイプ 説明
    msg 文字列 ログに書き込むメッセージ。
    表 : 21. 返される内容
    タイプ 説明
    なし
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logInfo("This is an info message");

    GSLog – logNotice(文字列 msg)

    通知イベントをログに記録します。

    表 : 22. パラメーター
    名前 タイプ 説明
    msg 文字列 ログに書き込むメッセージ。
    表 : 23. 返される内容
    タイプ 説明
    なし
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logNotice("This is a notice");

    出力:

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

    GSLog – logWarning(文字列 msg)

    警告イベントをログに記録します。

    表 : 24. パラメーター
    名前 タイプ 説明
    msg 文字列 ログに書き込むメッセージ。
    表 : 25. 返される内容
    タイプ 説明
    なし
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logWarning("This is a warning message");

    出力:

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

    GSLog – setLevel(文字列 level)

    ログレベルを設定します。

    表 : 26. パラメーター
    名前 タイプ 説明
    level 文字列 設定するログレベル。
    表 : 27. 返される内容
    タイプ 説明
    なし
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.setLevel("debug");