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 Cloud standard. Questo tipo di log è preferito per i log strutturati e l'jsonPayload supporto in Cloud Logging. Per il logging basato sul tempo, utilizza console.

Metodi

MetodoTipo restituitoBreve descrizione
clear()voidCancella il log.
getLog()StringRestituisce un elenco completo dei messaggi nel log corrente.
log(data)LoggerScrive i dati nel log.
log(format, values)LoggerScrive una stringa formattata nella console di log, 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 per 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);

Invio

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 passi 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 nel 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

NomeTipoDescrizione
dataObjectl'oggetto da registrare

Invio

Logger: il logger per l'accodamento.

log(format, values)

Scrive una stringa formattata nella console di log, utilizzando il formato e i valori forniti. La stringa può includere più segnaposto %s, che vengono sostituiti con i valori corrispondente 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

NomeTipoDescrizione
formatStringuna stringa di formato contenente il numero di istanze di %s uguale al numero di argomenti values
valuesObject...un numero variabile di valori da inserire nella stringa di formato

Invio

Logger: il logger per l'accodamento