---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GSProtokoll: Umfang, Global

# GSProtokoll: Umfang, Global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

GSProtokoll Ist eine Skripteinbindung, die die Skriptprotokollierung und das Debugging vereinfacht, indem Ebenen der Protokollausgabe implementiert werden, die durch die vom Aufrufer identifizierten sys_properties-Werte ausgewählt werden können.

Protokolle, die mit generiert wurden GSProtokoll API werden in den Systemprotokollen protokolliert. Insbesondere können Sie Systemprotokolle in der Anwenderoberfläche finden, indem Sie zu navigieren AlleSystemprotokolleSystemprotokollan. Sie können unter diesem Menüelement alle Protokolle oder bestimmte Protokolltypen wie Anwendungsprotokolle, Fehler, Skriptprotokollanweisungen usw. anzeigen. Filtern der Quellspalte in Alle Die Protokollansicht kann helfen, Ihre Einträge schneller zu finden.

Protokolle können sich auf der Ebene „Debuggen", „Info", „Hinweis", „Warnung", „Fehler" befinden. oder kritisch (nach BSD syslog.h und Follower). Die standardmäßige Protokollierungsebene ist „Hinweis", daher sollten Ebenen entsprechend ausgewählt werden.

Verwenden Sie diese Option für jedes serverseitige Skript, in dem Sie die Ereignisprotokollierung implementieren möchten.

Weitere Informationen finden Sie unter [Debugging-Skripts](https://www.servicenow.com/docs/access?context=script-debug-overview&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US).

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

Instanziiert einen GSProtokoll Objekt.
{#gsLog-GSLog__table_bln_fyx_15b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| TraceProperty | Zeichenfolge | Systemeigenschaft, die einen Wert enthält, der die Ebene angibt, auf der Nachrichten in das Protokoll geschrieben werden. |
| caller | Zeichenfolge | Name des Skripts, das den Protokollierer aufruft. |
[Tabelle : 1. Parameter]

{#gsLog-GSLog__table_bln_fyx_15b}  

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

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

Bestimmt, ob Debuggen aktiviert ist.
{#gsLog-debugOn__table_jyg_zmx_15b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 2. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob das Debuggen aktiviert oder deaktiviert ist. Gültige Werte: * Wahr: Debuggen ist aktiviert. * Falsch: Debuggen ist deaktiviert. {#gsLog-debugOn__ul_zcc_gxx_15b} |
[Tabelle : 3. Rückgaben]

{#gsLog-debugOn__table_kyg_zmx_15b}  

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

Ausgabe:

    *** Script : true

## GSLog -- getLevel (Zeichenfolgenebene) {#ariaid-title4}

Gibt die Protokollebene zurück.
{#gsLog-getLevel_S__table_tpq_j4x_15b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| level | Zeichenfolge | Optional. Protokollebene. |
[Tabelle : 4. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Protokollebene. |
[Tabelle : 5. Rückgaben]

{#gsLog-getLevel_S__table_upq_j4x_15b}  

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

Ausgabe:

    *** Script: debug

## GSLog -- initialisieren (Zeichenfolge traceProperty, Zeichenfolgenaufrufer) {#ariaid-title5}

Wird während der Objekterstellung vom Prototyp-JavaScript-Framework aufgerufen, um eine neue Instanz dieser Klasse zu initialisieren. Geben Sie die Eingabeparameter an, aber rufen Sie diese Methode nicht direkt auf.
{#gsLog-initialize_S_S__table_gjz_1nx_15b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| TraceProperty | Zeichenfolge | Systemeigenschaft, die einen Wert enthält, der die Ebene angibt, auf der Nachrichten in das Protokoll geschrieben werden. |
| caller | Zeichenfolge | Name des Skripts, das den Protokollierer aufruft. |
[Tabelle : 6. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 7. Rückgaben]

{#gsLog-initialize_S_S__table_hjz_1nx_15b}  

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

## GSLog -- Protokoll (Zeichenfolgenebene, Zeichenfolgennachricht) {#ariaid-title6}

Protokolliert eine Nachricht auf der angegebenen Ebene.
{#gsLog-log_S_S__table_sz4_m4x_15b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| level | Zeichenfolge | Protokollebene. |
| msg | Zeichenfolge | Nachricht, die in das Protokoll geschrieben werden soll. |
[Tabelle : 8. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 9. Rückgaben]

{#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 (Zeichenfolgennachricht) {#ariaid-title7}

Protokolliert Warnungsereignisse.
{#gsLog-logAlert_S__table_sz4_m4x_15b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| msg | Zeichenfolge | Nachricht, die in das Protokoll geschrieben werden soll. |
[Tabelle : 10. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. Rückgaben]

{#gsLog-logAlert_S__table_oh5_l4x_15b}  

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

Ausgabe:

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

## GSLog -- logCrit (Zeichenfolgennachricht) {#ariaid-title8}

Protokolliert kritische Ereignisse.
{#gsLog-logCrit_S__table_sz4_m4x_15b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| msg | Zeichenfolge | Nachricht, die in das Protokoll geschrieben werden soll. |
[Tabelle : 12. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 13. Rückgaben]

{#gsLog-logCrit_S__table_tz4_m4x_15b}  

    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logCrit("This is a critical message");

Ausgabe:

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

## GSLog -- logDebug(Zeichenfolgennachricht) {#ariaid-title9}

Protokolliert Debug-Ereignisse.
{#gsLog-logDebug_S__table_sz4_m4x_15b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| msg | Zeichenfolge | Nachricht, die in das Protokoll geschrieben werden soll. |
[Tabelle : 14. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 15. Rückgaben]

{#gsLog-logDebug_S__table_tz4_m4x_15b}  

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

Ausgabe:

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

## GSLog -- logEmerg(Zeichenfolgennachricht) {#ariaid-title10}

Protokolliert Notfallereignisse.
{#gsLog-logEmerg_S__table_sz4_m4x_15b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| msg | Zeichenfolge | Nachricht, die in das Protokoll geschrieben werden soll. |
[Tabelle : 16. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 17. Rückgaben]

{#gsLog-logEmerg_S__table_fbm_n4x_15b}  

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

Ausgabe:

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

## GSLog -- logErr(Zeichenfolgennachricht) {#ariaid-title11}

Protokolliert Fehlerereignisse.
{#gsLog-logErr_S__table_sz4_m4x_15b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| msg | Zeichenfolge | Nachricht, die in das Protokoll geschrieben werden soll. |
[Tabelle : 18. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 19. Rückgaben]

{#gsLog-logErr_S__table_kzj_44x_15b}  

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

Ausgabe:

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

## GSLog -- logInfo (Zeichenfolgennachricht) {#ariaid-title12}

Protokolliert Informationsereignisse.
{#gsLog-logInfo_S__table_e4f_p4x_15b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| msg | Zeichenfolge | Nachricht, die in das Protokoll geschrieben werden soll. |
[Tabelle : 20. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 21. Rückgaben]

{#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 -- Protokollhinweis (Zeichenfolgennachricht) {#ariaid-title13}

Protokolliert Benachrichtigungsereignisse.
{#gsLog-logNotice_S__table_sz4_m4x_15b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| msg | Zeichenfolge | Nachricht, die in das Protokoll geschrieben werden soll. |
[Tabelle : 22. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 23. Rückgaben]

{#gsLog-logNotice_S__table_kdc_q4x_15b}  

    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logNotice("This is a notice");

Ausgabe:

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

## GSLog -- Protokollwarnung (Zeichenfolgennachricht) {#ariaid-title14}

Protokolliert Warnungsereignisse.
{#gsLog-logWarning_S__table_sz4_m4x_15b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| msg | Zeichenfolge | Nachricht, die in das Protokoll geschrieben werden soll. |
[Tabelle : 24. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 25. Rückgaben]

{#gsLog-logWarning_S__table_fwt_s4x_15b}  

    var gl = new GSLog("com.snc.sla.tasksla.log", "TaskSLA"); 
    gl.logWarning("This is a warning message");

Ausgabe:

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

## GSLog -- setLevel (Zeichenfolgenebene) {#ariaid-title15}

Legt die Protokollebene fest.
{#gsLog-setLevel_S__table_tpq_j4x_15b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| level | Zeichenfolge | Festzulegende Protokollebene. |
[Tabelle : 26. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 27. Rückgaben]

{#gsLog-setLevel_S__table_fwt_s4x_15b}  

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


