Class Logger

Logger

Esta clase permite que el desarrollador escriba en el registro de ejecución y en Cloud Logging de Google si la secuencia de comandos está asociada con 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étodoTipo de datos que se muestraDescripción breve
clear()voidBorra el registro.
getLog()StringMuestra una lista completa de los mensajes del registro actual.
log(data)LoggerEscribe los datos en el registro.
log(format, values)LoggerEscribe una cadena con formato en la consola de registro con el formato y los valores proporcionados.

Documentación detallada

clear()

Borra el registro.

getLog()

Muestra 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 registro.

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 pasas 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

NombreTipoDescripción
dataObjectel objeto que se registrará

Volver

Logger: Es el registrador para encadenar.

log(format, values)

Escribe una cadena con formato en la consola de registro con 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

NombreTipoDescripción
formatStringuna cadena de formato que contiene tantas instancias de %s como la cantidad de argumentos values
valuesObject...Una cantidad variable de valores para insertar en la cadena de formato

Volver

Logger: Es el registrador para encadenar.