GSLog - com escopo, global

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 4 min. de leitura
  • GSLog é uma inclusão de script que simplifica o registro em log e a depuração de scripts implementando níveis de saída de log, selecionáveis por valores de sys_properties identificados por solicitante.

    Os logs podem estar no nível de depuração, informações, aviso, aviso, erro ou crit (após BSD syslog.h e seguidores). O nível de registro em log padrão é aviso, portanto, os níveis devem ser escolhidos de acordo.

    Use para qualquer script do lado do servidor em que você deseja implementar o registro em log de eventos.

    Para obter mais informações, consulte Depuração de scripts.

    GSLog – GSLog()

    Instancia um objeto GSLog.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    TraceProperty Cadeia de caracteres Propriedade do sistema que contém um valor que indica o nível igual ou superior ao qual as mensagens serão gravadas no log.
    Solicitante Cadeia de caracteres Nome do script que chama o agente de log.
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA");

    GSLog – debugOn()

    Determina se a depuração está ativada.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 3. Retorna
    Tipo Descrição
    Booliano

    Sinalizador que indica se a depuração está ativada ou desativada.

    Valores válidos:
    • verdadeiro: a depuração está ativada.
    • falso: a depuração está desativada.
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.setLevel("debug");
    gs.print(gl.debugOn());

    Saída:

    *** Script : true

    GSLog – getLevel(nível de cadeia de caracteres)

    Retorna o nível de log.

    Tabela 4. Parâmetros
    Nome Tipo Descrição
    nível Cadeia de caracteres Opcional. Nível de log.
    Tabela 5. Retorna
    Tipo Descrição
    Cadeia de caracteres Nível de log.
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.setLevel("debug");
    gs.print(gl.getLevel());

    Saída:

    *** Script: debug

    GSLog – inicializar (cadeia de caracteres "traceProperty", cadeia de caracteres solicitante)

    Chamado pelo Prototype JavaScript Framework durante a criação do objeto para inicializar uma nova instância desta classe. Forneça os parâmetros de entrada, mas não chame este método diretamente.

    Tabela 6. Parâmetros
    Nome Tipo Descrição
    TraceProperty Cadeia de caracteres Propriedade do sistema que contém um valor que indica o nível igual ou superior ao qual as mensagens serão gravadas no log.
    Solicitante Cadeia de caracteres Nome do script que chama o agente de log.
    Tabela 7. Retorna
    Tipo Descrição
    Nenhum
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA");
    

    GSLog – log (nível de cadeia de caracteres, mensagem de cadeia de caracteres)

    Registra em log uma mensagem no nível especificado.

    Tabela 8. Parâmetros
    Nome Tipo Descrição
    nível Cadeia de caracteres Nível de log.
    msg Cadeia de caracteres Mensagem a ser gravada no log.
    Tabela 9. Retorna
    Tipo Descrição
    Nenhum
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.log("debug", "debug message");

    GSLog – logAlert(cadeia de caracteres mensagem)

    Registra em log eventos de alerta.

    Tabela 10. Parâmetros
    Nome Tipo Descrição
    msg Cadeia de caracteres Mensagem a ser gravada no log.
    Tabela 11. Retorna
    Tipo Descrição
    Nenhum(a)
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logAlert("This is an alert");

    Saída:

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

    GSLog – logCrit(cadeia de caracteres mensagem)

    Registra em log eventos críticos.

    Tabela 12. Parâmetros
    Nome Tipo Descrição
    msg Cadeia de caracteres Mensagem a ser gravada no log.
    Tabela 13. Retorna
    Tipo Descrição
    Nenhum(a)
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logCrit("This is a critical message");

    Saída:

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

    GSLog – logDebug(cadeia de caracteres mensagem)

    Registra em log eventos de depuração.

    Tabela 14. Parâmetros
    Nome Tipo Descrição
    msg Cadeia de caracteres Mensagem a ser gravada no log.
    Tabela 15. Retorna
    Tipo Descrição
    Nenhum(a)
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logDebug("This is a debug message");

    Saída:

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

    GSLog – logEmerg(cadeia de caracteres mensagem)

    Registra eventos de emergência.

    Tabela 16. Parâmetros
    Nome Tipo Descrição
    msg Cadeia de caracteres Mensagem a ser gravada no log.
    Tabela 17. Retorna
    Tipo Descrição
    Nenhum(a)
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logEmerg("This is an emergency message");

    Saída:

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

    GSLog – logErr(cadeia de caracteres mensagem)

    Registra em log eventos de erro.

    Tabela 18. Parâmetros
    Nome Tipo Descrição
    msg Cadeia de caracteres Mensagem a ser gravada no log.
    Tabela 19. Retorna
    Tipo Descrição
    Nenhum(a)
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logErr("This is an error message");

    Saída:

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

    GSLog – logInfo(cadeia de caracteres mensagem)

    Registra eventos de informações.

    Tabela 20. Parâmetros
    Nome Tipo Descrição
    msg Cadeia de caracteres Mensagem a ser gravada no log.
    Tabela 21. Retorna
    Tipo Descrição
    Nenhum
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logInfo("This is an info message");

    GSLog – logNotice (cadeia de caracteres de mensagem)

    Registra em log eventos de aviso.

    Tabela 22. Parâmetros
    Nome Tipo Descrição
    msg Cadeia de caracteres Mensagem a ser gravada no log.
    Tabela 23. Retorna
    Tipo Descrição
    Nenhum(a)
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logNotice("This is a notice");

    Saída:

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

    GSLog – logWarning(cadeia de caracteres mensagem)

    Registra em log eventos de aviso.

    Tabela 24. Parâmetros
    Nome Tipo Descrição
    msg Cadeia de caracteres Mensagem a ser gravada no log.
    Tabela 25. Retorna
    Tipo Descrição
    Nenhum(a)
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logWarning("This is a warning message");

    Saída:

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

    GSLog – setLevel(cadeia de caracteres nível)

    Define o nível do log.

    Tabela 26. Parâmetros
    Nome Tipo Descrição
    nível Cadeia de caracteres Nível de log a ser definido.
    Tabela 27. Retorna
    Tipo Descrição
    Nenhum
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.setLevel("debug");