GSLog - escopo, global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura

    • GSLog é uma inclusão de script que simplifica o registro em log e a depuração de script implementando níveis de saída de log, selecionáveis por valores sys_properties identificados por chamador.

    Logs gerados usando GSLog As APIs são registradas em log nos Logs do sistema. Especificamente, você pode encontrar Logs do sistema na IU navegando até Tudo > Logs do sistema > Log do Sistema. Você pode optar por exibir todos os logs ou tipos de log específicos, como Logs de aplicações, Erros, Declarações de log de script e assim por diante neste item de menu. Filtrando a coluna Origem no Todos a exibição de logs pode ajudar a localizar suas entradas mais rapidamente.

    Os logs podem estar no nível de depuração, informação, aviso, aviso, erro, ou crit (após o 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 Scripts de depuração .

    GSLog – GSLog()

    Instancia um GSLog objeto.

    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 em 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á desativada.
    		 
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
gl.setLevel("debug");
gs.print(gl.debugOn());

    Saída:

    *** Script : true

    GLog – 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. Retornos
    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 – initialize(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 em 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. Retornos
    Tipo Descrição
    Nenhum 
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA");

    Log - log (nível de cadeia de caracteres, mensagem de cadeia de caracteres)

    Registra 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. Retornos
    Tipo Descrição
    Nenhum 
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
gl.log("debug", "debug message");

    LogAlert (mensagem de cadeia de caracteres)

    Registra eventos de alerta.

    Tabela 10. Parâmetros
    Nome Tipo Descrição
    msg Cadeia de caracteres Mensagem a ser gravada no log.
    Tabela 11. Retornos
    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

    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. Retornos
    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

    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. Retornos
    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

    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. Retornos
    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

    LogErr (mensagem de cadeia de caracteres)

    Registra eventos de erro.

    Tabela 18. Parâmetros
    Nome Tipo Descrição
    msg Cadeia de caracteres Mensagem a ser gravada no log.
    Tabela 19. Retornos
    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

    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. Retornos
    Tipo Descrição
    Nenhum 
    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
gl.logInfo("This is an info message");

    LogNotice (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. Retornos
    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

    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. Retornos
    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 (nível de cadeia de caracteres)

    Define o nível de log.

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