---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GSLog - com escopo, global

# GSLog - com escopo, global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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](https://www.servicenow.com/docs/access?context=script-debug-overview&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US).

## GSLog -- GSLog() {#ariaid-title2}

Instancia um objeto GSLog.
{#gsLog-GSLog__table_bln_fyx_15b__entry__3}

| 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 1. Parâmetros]

{#gsLog-GSLog__table_bln_fyx_15b}  

    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA");

## GSLog -- debugOn() {#ariaid-title3}

Determina se a depuração está ativada.
{#gsLog-debugOn__table_jyg_zmx_15b__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 2. Parâmetros]

{#gsLog-debugOn__table_jyg_zmx_15b} {#gsLog-debugOn__table_kyg_zmx_15b__entry__2}

| 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. {#gsLog-debugOn__ul_zcc_gxx_15b} |
[Tabela 3. Retorna]

{#gsLog-debugOn__table_kyg_zmx_15b}  

    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) {#ariaid-title4}

Retorna o nível de log.
{#gsLog-getLevel_S__table_tpq_j4x_15b__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nível | Cadeia de caracteres | Opcional. Nível de log. |
[Tabela 4. Parâmetros]

{#gsLog-getLevel_S__table_tpq_j4x_15b} {#gsLog-getLevel_S__table_upq_j4x_15b__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Nível de log. |
[Tabela 5. Retorna]

{#gsLog-getLevel_S__table_upq_j4x_15b}  

    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) {#ariaid-title5}

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.
{#gsLog-initialize_S_S__table_gjz_1nx_15b__entry__3}

| 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 6. Parâmetros]

{#gsLog-initialize_S_S__table_gjz_1nx_15b} {#gsLog-initialize_S_S__table_hjz_1nx_15b__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum |   |
[Tabela 7. Retorna]

{#gsLog-initialize_S_S__table_hjz_1nx_15b}  

    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA");

## GSLog -- log (nível de cadeia de caracteres, mensagem de cadeia de caracteres) {#ariaid-title6}

Registra em log uma mensagem no nível especificado.
{#gsLog-log_S_S__table_sz4_m4x_15b__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nível | Cadeia de caracteres | Nível de log. |
| msg | Cadeia de caracteres | Mensagem a ser gravada no log. |
[Tabela 8. Parâmetros]

{#gsLog-log_S_S__table_sz4_m4x_15b} {#gsLog-log_S_S__table_jdw_k4x_15b__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum |   |
[Tabela 9. Retorna]

{#gsLog-log_S_S__table_jdw_k4x_15b}  

    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.log("debug", "debug message");

## GSLog -- logAlert(cadeia de caracteres mensagem) {#ariaid-title7}

Registra em log eventos de alerta.
{#gsLog-logAlert_S__table_sz4_m4x_15b__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| msg | Cadeia de caracteres | Mensagem a ser gravada no log. |
[Tabela 10. Parâmetros]

{#gsLog-logAlert_S__table_sz4_m4x_15b} {#gsLog-logAlert_S__table_oh5_l4x_15b__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 11. Retorna]

{#gsLog-logAlert_S__table_oh5_l4x_15b}  

    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) {#ariaid-title8}

Registra em log eventos críticos.
{#gsLog-logCrit_S__table_sz4_m4x_15b__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| msg | Cadeia de caracteres | Mensagem a ser gravada no log. |
[Tabela 12. Parâmetros]

{#gsLog-logCrit_S__table_sz4_m4x_15b} {#gsLog-logCrit_S__table_tz4_m4x_15b__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 13. Retorna]

{#gsLog-logCrit_S__table_tz4_m4x_15b}  

    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) {#ariaid-title9}

Registra em log eventos de depuração.
{#gsLog-logDebug_S__table_sz4_m4x_15b__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| msg | Cadeia de caracteres | Mensagem a ser gravada no log. |
[Tabela 14. Parâmetros]

{#gsLog-logDebug_S__table_sz4_m4x_15b} {#gsLog-logDebug_S__table_tz4_m4x_15b__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 15. Retorna]

{#gsLog-logDebug_S__table_tz4_m4x_15b}  

    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) {#ariaid-title10}

Registra eventos de emergência.
{#gsLog-logEmerg_S__table_sz4_m4x_15b__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| msg | Cadeia de caracteres | Mensagem a ser gravada no log. |
[Tabela 16. Parâmetros]

{#gsLog-logEmerg_S__table_sz4_m4x_15b} {#gsLog-logEmerg_S__table_fbm_n4x_15b__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 17. Retorna]

{#gsLog-logEmerg_S__table_fbm_n4x_15b}  

    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) {#ariaid-title11}

Registra em log eventos de erro.
{#gsLog-logErr_S__table_sz4_m4x_15b__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| msg | Cadeia de caracteres | Mensagem a ser gravada no log. |
[Tabela 18. Parâmetros]

{#gsLog-logErr_S__table_sz4_m4x_15b} {#gsLog-logErr_S__table_kzj_44x_15b__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 19. Retorna]

{#gsLog-logErr_S__table_kzj_44x_15b}  

    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) {#ariaid-title12}

Registra eventos de informações.
{#gsLog-logInfo_S__table_e4f_p4x_15b__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| msg | Cadeia de caracteres | Mensagem a ser gravada no log. |
[Tabela 20. Parâmetros]

{#gsLog-logInfo_S__table_e4f_p4x_15b} {#gsLog-logInfo_S__table_f4f_p4x_15b__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum |   |
[Tabela 21. Retorna]

{#gsLog-logInfo_S__table_f4f_p4x_15b}  

    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logInfo("This is an info message");

## GSLog -- logNotice (cadeia de caracteres de mensagem) {#ariaid-title13}

Registra em log eventos de aviso.
{#gsLog-logNotice_S__table_sz4_m4x_15b__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| msg | Cadeia de caracteres | Mensagem a ser gravada no log. |
[Tabela 22. Parâmetros]

{#gsLog-logNotice_S__table_sz4_m4x_15b} {#gsLog-logNotice_S__table_kdc_q4x_15b__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 23. Retorna]

{#gsLog-logNotice_S__table_kdc_q4x_15b}  

    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) {#ariaid-title14}

Registra em log eventos de aviso.
{#gsLog-logWarning_S__table_sz4_m4x_15b__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| msg | Cadeia de caracteres | Mensagem a ser gravada no log. |
[Tabela 24. Parâmetros]

{#gsLog-logWarning_S__table_sz4_m4x_15b} {#gsLog-logWarning_S__table_fwt_s4x_15b__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 25. Retorna]

{#gsLog-logWarning_S__table_fwt_s4x_15b}  

    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) {#ariaid-title15}

Define o nível do log.
{#gsLog-setLevel_S__table_tpq_j4x_15b__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nível | Cadeia de caracteres | Nível de log a ser definido. |
[Tabela 26. Parâmetros]

{#gsLog-setLevel_S__table_tpq_j4x_15b} {#gsLog-setLevel_S__table_fwt_s4x_15b__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum |   |
[Tabela 27. Retorna]

{#gsLog-setLevel_S__table_fwt_s4x_15b}  

    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.setLevel("debug");