Class Logger

Logger

Ta klasa umożliwia deweloperowi zapisywanie danych w dzienniku wykonania i w Google Cloud Logging, jeśli skrypt jest powiązany z standardowym projektem Cloud. Ta klasa jest preferowana w przypadku rejestrowania strukturalnego i jsonPayload w Cloud Logging. W przypadku rejestrowania na podstawie czasu użyj symbolu console.

Metody

Metoda	Zwracany typ	Krótki opis
clear()	void	Czyści dziennik.
getLog()	String	Zwraca pełną listę wiadomości w bieżącym logu.
log(data)	Logger	Zapisuje dane w dzienniku.
log(format, values)	Logger	Zapisuje sformatowany ciąg znaków w konsoli logowania, używając podanego formatu i wartości.

Szczegółowa dokumentacja

clear()

Czyści dziennik.

---

getLog()

Zwraca pełną listę wiadomości w bieżącym logu. Za pomocą tej metody możesz zapisać lub wysłać e-mailem wszystkie dane wyjściowe dziennika wygenerowane podczas wykonywania skryptu.

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

Powrót

String – dziennik z konsoli logowania.

---

log(data)

Zapisuje dane w dzienniku. Dane mogą być ciągiem znaków, obiektem JavaScript lub obiektem z właściwością 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

Jeśli przekazywany obiekt zawiera właściwość message, właściwość ta jest używana jako komunikat logu. W przeciwnym razie wywoływana jest metoda toString(), aby przekonwertować obiekt na ciąg znaków. Wszystkie inne właściwości, które można serializować do formatu JSON, są uwzględniane w jsonPayload w LogEntry, podobnie jak w przykładzie poniżej:

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

Parametry

Nazwa	Typ	Opis
data	Object	obiekt do zarejestrowania,

Powrót

Logger – moduł zbierający logi do łączenia w łańcuch.

---

log(format, values)

Zapisuje sformatowany ciąg znaków w konsoli logowania, używając podanego formatu i wartości. Ciąg tekstowy może zawierać wiele obiektów zastępczych %s, które są zastępowane odpowiednimi wartościami z listy argumentów przekształconymi w ciągi tekstowe.

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

Parametry

Nazwa	Typ	Opis
format	String	ciąg formatujący, który zawiera tyle wystąpień %s, ile jest argumentów values;
values	Object...	zmienna liczba wartości do wstawienia w ciągu formatującym.

Powrót

Logger – rejestrator do łączenia w łańcuch