---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GSLog - Champ d'application, global

# GSLog - Champ d'application, global {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes de lecture

GSLog est un include de script qui simplifie la journalisation et le débogage des scripts en implémentant des niveaux de sortie de journal, sélectionnables par les valeurs de sys_properties identifiées par appelant.

Les logs peuvent être au niveau du débogage, de l'info, de l'avis, de l'avertissement, de l'erreur ou du critique (après BSD syslog.h et suiveurs). Le niveau de journalisation par défaut est notice, les niveaux doivent donc être choisis en conséquence.

À utiliser pour n'importe quel script côté serveur dans lequel vous souhaitez implémenter la journalisation des événements.

Pour plus d'informations, consultez [Débogage 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}

Instancie un objet GSLog .
{#gsLog-GSLog__table_bln_fyx_15b__entry__3}

| Nom | Type | Description |
|-|-|-|
| traceProperty (en anglais seulement) | Chaîne | Propriété système qui contient une valeur indiquant le niveau auquel ou au-dessus duquel les messages seront écrits dans le journal. |
| appelant | Chaîne | Nom du script appelant l'enregistreur. |
[Tableau 1. Paramètres]

{#gsLog-GSLog__table_bln_fyx_15b}  

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

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

Détermine si le débogage est activé.
{#gsLog-debugOn__table_jyg_zmx_15b__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 2. Paramètres]

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

| Type | Description |
|-|-|
| Booléen | Marqueur indiquant si le débogage est activé ou désactivé. Valeurs valides : * true : le débogage est activé. * faux : le débogage est désactivé. {#gsLog-debugOn__ul_zcc_gxx_15b} |
[Tableau 3. Renvoie]

{#gsLog-debugOn__table_kyg_zmx_15b}  

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

Sortie :

    *** Script : true

## GSLog -- getLevel(niveau de la chaîne) {#ariaid-title4}

Renvoie le niveau de journalisation.
{#gsLog-getLevel_S__table_tpq_j4x_15b__entry__3}

| Nom | Type | Description |
|-|-|-|
| niveau | Chaîne | Facultatif. Niveau de journal. |
[Tableau 4. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Niveau de journal. |
[Tableau 5. Renvoie]

{#gsLog-getLevel_S__table_upq_j4x_15b}  

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

Sortie :

    *** Script: debug

## GSLog -- initialize(String traceProperty, String caller) {#ariaid-title5}

Appelé par le Prototype JavaScript Framework lors de la création d'un objet pour initialiser une nouvelle instance de cette classe. Fournissez les paramètres d'entrée, mais n'appelez pas cette méthode directement.
{#gsLog-initialize_S_S__table_gjz_1nx_15b__entry__3}

| Nom | Type | Description |
|-|-|-|
| traceProperty (en anglais seulement) | Chaîne | Propriété système qui contient une valeur indiquant le niveau auquel ou au-dessus duquel les messages seront écrits dans le journal. |
| appelant | Chaîne | Nom du script appelant l'enregistreur. |
[Tableau 6. Paramètres]

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

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 7. Renvoie]

{#gsLog-initialize_S_S__table_hjz_1nx_15b}  

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

## GSLog -- log(niveau de la chaîne, message de la chaîne) {#ariaid-title6}

Consigne un message au niveau spécifié.
{#gsLog-log_S_S__table_sz4_m4x_15b__entry__3}

| Nom | Type | Description |
|-|-|-|
| niveau | Chaîne | Niveau de journal. |
| msg | Chaîne | Message à écrire dans le journal. |
[Tableau 8. Paramètres]

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

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 9. Renvoie]

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

Consigne les événements d'alerte.
{#gsLog-logAlert_S__table_sz4_m4x_15b__entry__3}

| Nom | Type | Description |
|-|-|-|
| msg | Chaîne | Message à écrire dans le journal. |
[Tableau 10. Paramètres]

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

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 11. Renvoie]

{#gsLog-logAlert_S__table_oh5_l4x_15b}  

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

Sortie :

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

## GSLog -- logCrit(String msg) {#ariaid-title8}

Consigne les événements critiques.
{#gsLog-logCrit_S__table_sz4_m4x_15b__entry__3}

| Nom | Type | Description |
|-|-|-|
| msg | Chaîne | Message à écrire dans le journal. |
[Tableau 12. Paramètres]

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

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 13. Renvoie]

{#gsLog-logCrit_S__table_tz4_m4x_15b}  

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

Sortie :

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

## GSLog -- logDebug(String msg) {#ariaid-title9}

Consigne les événements de débogage.
{#gsLog-logDebug_S__table_sz4_m4x_15b__entry__3}

| Nom | Type | Description |
|-|-|-|
| msg | Chaîne | Message à écrire dans le journal. |
[Tableau 14. Paramètres]

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

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 15. Renvoie]

{#gsLog-logDebug_S__table_tz4_m4x_15b}  

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

Sortie :

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

## GSLog -- logEmerg(chaîne msg) {#ariaid-title10}

Consigne les événements d'urgence.
{#gsLog-logEmerg_S__table_sz4_m4x_15b__entry__3}

| Nom | Type | Description |
|-|-|-|
| msg | Chaîne | Message à écrire dans le journal. |
[Tableau 16. Paramètres]

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

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 17. Renvoie]

{#gsLog-logEmerg_S__table_fbm_n4x_15b}  

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

Sortie :

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

## GSLog -- logErr(String msg) {#ariaid-title11}

Consigne les événements d'erreur.
{#gsLog-logErr_S__table_sz4_m4x_15b__entry__3}

| Nom | Type | Description |
|-|-|-|
| msg | Chaîne | Message à écrire dans le journal. |
[Tableau 18. Paramètres]

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

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 19. Renvoie]

{#gsLog-logErr_S__table_kzj_44x_15b}  

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

Sortie :

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

## GSLog -- logInfo(String msg) {#ariaid-title12}

Consigne les événements d'information.
{#gsLog-logInfo_S__table_e4f_p4x_15b__entry__3}

| Nom | Type | Description |
|-|-|-|
| msg | Chaîne | Message à écrire dans le journal. |
[Tableau 20. Paramètres]

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

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 21. Renvoie]

{#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(String msg) {#ariaid-title13}

Les journaux signalent des événements.
{#gsLog-logNotice_S__table_sz4_m4x_15b__entry__3}

| Nom | Type | Description |
|-|-|-|
| msg | Chaîne | Message à écrire dans le journal. |
[Tableau 22. Paramètres]

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

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 23. Renvoie]

{#gsLog-logNotice_S__table_kdc_q4x_15b}  

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

Sortie :

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

## GSLog -- logWarning(String msg) {#ariaid-title14}

Consigne les événements d'avertissement.
{#gsLog-logWarning_S__table_sz4_m4x_15b__entry__3}

| Nom | Type | Description |
|-|-|-|
| msg | Chaîne | Message à écrire dans le journal. |
[Tableau 24. Paramètres]

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

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 25. Renvoie]

{#gsLog-logWarning_S__table_fwt_s4x_15b}  

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

Sortie :

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

## GSLog -- setLevel(Niveau de la chaîne) {#ariaid-title15}

Définit le niveau de journalisation.
{#gsLog-setLevel_S__table_tpq_j4x_15b__entry__3}

| Nom | Type | Description |
|-|-|-|
| niveau | Chaîne | Niveau de journal à définir. |
[Tableau 26. Paramètres]

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

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 27. Renvoie]

{#gsLog-setLevel_S__table_fwt_s4x_15b}  

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