Этот класс позволяет разработчику вести запись в журнал выполнения и в Google Cloud Logging, если сценарий связан со стандартным облачным проектом . Этот класс предпочтителен для структурированного ведения журналов и поддержки json Payload
в Cloud Logging. Для регистрации по времени используйте console
.
Методы
Метод | Тип возврата | Краткое описание |
---|---|---|
clear() | void | Очищает журнал. |
get Log() | String | Возвращает полный список сообщений в текущем журнале. |
log(data) | Logger | Записывает данные в журнал. |
log(format, values) | Logger | Записывает форматированную строку в консоль журналирования, используя предоставленный формат и значения. |
Подробная документация
clear()
Очищает журнал.
get Log()
Возвращает полный список сообщений в текущем журнале. Этот метод можно использовать для сохранения или отправки по электронной почте всей информации журнала, созданной во время выполнения сценария.
// 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);
Возвращаться
String
— лог из консоли логирования
log(data)
Записывает данные в журнал. Данные могут быть строкой, объектом JavaScript или объектом со свойством 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
Если при передаче объекта объект содержит свойство message
, это свойство используется в качестве сообщения журнала. В противном случае вызывается метод to String()
для преобразования объекта в строку. Все остальные свойства, которые можно сериализовать в формате JSON, включаются как часть json Payload
в Log Entry
, как показано в примере ниже:
{ "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" }
Параметры
Имя | Тип | Описание |
---|---|---|
data | Object | объект для регистрации |
Возвращаться
Logger
— Регистратор для цепочки.
log(format, values)
Записывает форматированную строку в консоль журналирования, используя предоставленный формат и значения. Строка может включать несколько заполнителей %s
, которые заменяются соответствующими значениями из списка аргументов, преобразованными в строки.
// 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);
Параметры
Имя | Тип | Описание |
---|---|---|
format | String | строка формата, содержащая столько экземпляров %s сколько аргументов values |
values | Object... | переменное количество значений для вставки в строку формата |
Возвращаться
Logger
— Регистратор для цепочки