Class Logger

Logger

Questa classe consente allo sviluppatore di scrivere nel log di esecuzione e in Google Cloud Logging se lo script è associato a un progetto Google Cloud standard. Questa classe è preferita per la registrazione strutturata e il supporto di jsonPayload in Cloud Logging. Per la registrazione basata sul tempo, utilizza console.

Metodi

Metodo	Tipo restituito	Breve descrizione
clear()	void	Cancella il log.
getLog()	String	Restituisce un elenco completo dei messaggi nel log corrente.
log(data)	Logger	Scrive i dati nel log.
log(format, values)	Logger	Scrive una stringa formattata nella console di logging, utilizzando il formato e i valori forniti.

Documentazione dettagliata

clear()

Cancella il log.

---

getLog()

Restituisce un elenco completo dei messaggi nel log corrente. Questo metodo può essere utilizzato per salvare o inviare via email l'intero output del log generato durante l'esecuzione dello script.

// Generate a log, then email it to the person who ran the script.
const files = DriveApp.getFiles();
while (files.hasNext()) {
  Logger.log(files.next().getName());
}
const recipient = Session.getActiveUser().getEmail();
const subject = 'A list of files in your Google Drive';
const body = Logger.getLog();
MailApp.sendEmail(recipient, subject, body);

Indietro

String: il log della console di logging

---

log(data)

Scrive i dati nel log. I dati possono essere una stringa, un oggetto JavaScript o un oggetto con una proprietà message.

Logger.log("my log message");
// Info   my logmessage
Logger.log({ key: "value" });
// Info   {key=value}
Logger.log({ message: "my log message", data: { key: "value" } })
// Info   my logmessage

Quando viene passato un oggetto, se l'oggetto contiene una proprietà message, questa viene utilizzata come messaggio di log. In caso contrario, viene chiamato il metodo toString() per convertire l'oggetto in una stringa. Tutte le altre proprietà serializzabili in JSON sono incluse come parte di jsonPayload in LogEntry, in modo simile all'esempio seguente:

{
  "insertId": "w5eib...",
  "jsonPayload": {
    "message": "my log message",
    "serviceContext": {
      "service": "AKfyc..."
    },
    "data": {
      "key": "value"
    }
  },
  "resource": {
    "type": "app_script_function",
    "labels": {
      "invocation_type": "editor",
      "function_name": "unknown",
      "project_id": "1234567890"
    }
  },
  "timestamp": "2024-11-15T23:28:19.448591Z",
  "severity": "INFO",
  "labels": {
    "script.googleapis.com/user_key": "AOX2d...",
    "script.googleapis.com/process_id": "EAEA1...",
    "script.googleapis.com/project_key": "MQXvl...",
    "script.googleapis.com/deployment_id": "AKfyc..."
  },
  "logName": "projects/[PROJECT_ID]/logs/script.googleapis.com%2Fconsole_logs",
  "receiveTimestamp": "2024-11-15T23:28:20.363790313Z"
}

Parametri

Nome	Tipo	Descrizione
data	Object	l'oggetto da registrare

Indietro

Logger: il logger, per il concatenamento.

---

log(format, values)

Scrive una stringa formattata nella console di logging, utilizzando il formato e i valori forniti. La stringa può includere più segnaposto %s, che vengono sostituiti con i valori corrispondenti dell'elenco di argomenti, convertiti in stringhe.

// Log the number of Google Groups you belong to.
const groups = GroupsApp.getGroups();
Logger.log('You are a member of %s Google Groups.', groups.length);

Parametri

Nome	Tipo	Descrizione
format	String	una stringa di formato che contiene tante istanze di %s quanti sono gli argomenti values
values	Object...	un numero variabile di valori da inserire nella stringa di formato

Indietro

Logger: il logger, per il concatenamento