GSLog - com escopo, global

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 4 min. de leitura
  • O GSLog é uma inclusão de script que simplifica o registro em log e a depuração do script, 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ê queira 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 indicando o nível no qual ou acima do 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á desabilitada.
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.setLevel("debug");
    gs.print(gl.debugOn());

    Saída:

    *** Script : true

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

    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 indicando o nível no qual ou acima do 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 "msg")

    Registra 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
    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 "msg")

    Registra 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
    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 "msg")

    Registra 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
    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 "msg")

    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
    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 "msg")

    Registra 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
    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 "msg")

    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 – logNovice(cadeia de caracteres "msg")

    Registra 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
    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 "msg")

    Registra 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
    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");