Class Logger

Logger

Esta clase permite que el desarrollador escriba en el registro de ejecución y en Google Cloud Logging si la secuencia de comandos está asociada a un proyecto de Cloud estándar. Esta clase es preferible para el registro estructurado y la compatibilidad con jsonPayload en Cloud Logging. Para el registro basado en el tiempo, usa console.

Métodos

Método	Tipo de datos que se devuelve	Descripción breve
clear()	void	Borra el registro.
getLog()	String	Devuelve una lista completa de los mensajes del registro actual.
log(data)	Logger	Escribe los datos en el registro.
log(format, values)	Logger	Escribe una cadena con formato en la consola de registro, usando el formato y los valores proporcionados.

Documentación detallada

clear()

Borra el registro.

---

getLog()

Devuelve una lista completa de los mensajes del registro actual. Este método se puede usar para guardar o enviar por correo electrónico todo el resultado del registro generado durante la ejecución de la secuencia de comandos.

// 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);

Volver

String: Es el registro de la consola de Logging.

---

log(data)

Escribe los datos en el registro. Los datos pueden ser una cadena, un objeto JavaScript o un objeto con una propiedad 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

Cuando se pasa un objeto, si este contiene una propiedad message, esa propiedad se usa como el mensaje de registro. De lo contrario, se llama al método toString() para convertir el objeto en una cadena. Todas las demás propiedades que se pueden serializar en JSON se incluyen como parte de jsonPayload en LogEntry, de manera similar al siguiente ejemplo:

{
  "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"
}

Parámetros

Nombre	Tipo	Descripción
data	Object	El objeto que se registrará

Volver

Logger: Es el objeto Logger, para el encadenamiento.

---

log(format, values)

Escribe una cadena con formato en la consola de registro, usando el formato y los valores proporcionados. La cadena puede incluir varios marcadores de posición %s, que se reemplazan por los valores correspondientes de la lista de argumentos, convertidos en cadenas.

// 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);

Parámetros

Nombre	Tipo	Descripción
format	String	cadena de formato que contiene tantas instancias de %s como la cantidad de argumentos de values
values	Object...	Una cantidad variable de valores para insertar en la cadena de formato

Volver

Logger: Logger, para encadenar