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
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 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
Nome | Tipo | Descrizione |
---|---|---|
data | Object | l'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
Nome | Tipo | Descrizione |
---|---|---|
format | String | una stringa di formato contenente il numero di istanze di %s uguale al numero di argomenti
values |
values | Object... | un numero variabile di valori da inserire nella stringa di formato |
Invio
Logger
: il logger per l'accodamento