Class Logger

Logger

Bu sınıf, geliştiricinin komut dosyası standart Cloud projesi ile ilişkilendirilmişse yürütme günlüğüne ve Google Cloud Logging'e yazmasına olanak tanır. Bu sınıf, Cloud Logging'de yapılandırılmış günlük kaydı ve jsonPayload desteği için tercih edilir. Zamana dayalı günlük kaydı için console kullanın.

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
clear()	void	Günlüğü temizler.
getLog()	String	Mevcut günlükteki iletilerin tam listesini döndürür.
log(data)	Logger	Verileri günlük dosyasına yazar.
log(format, values)	Logger	Biçimlendirilmiş bir dizeyi, sağlanan biçim ve değerleri kullanarak günlük kaydı konsoluna yazar.

Ayrıntılı belgeler

clear()

Günlüğü temizler.

---

getLog()

Mevcut günlükteki iletilerin tam listesini döndürür. Bu yöntem, komut dosyası yürütme sırasında oluşturulan tüm günlük çıkışını kaydetmek veya e-postayla göndermek için kullanılabilir.

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

Return

String: Günlük kaydı konsolundaki günlük

---

log(data)

Verileri günlük dosyasına yazar. Veriler dize, JavaScript nesnesi veya message özelliği olan bir nesne olabilir.

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

Bir nesne iletilirken nesne message özelliği içeriyorsa bu özellik günlük mesajı olarak kullanılır. Aksi takdirde, nesneyi dizeye dönüştürmek için toString() yöntemi çağrılır. JSON olarak serileştirilebilen diğer tüm özellikler, aşağıdaki örnekte olduğu gibi LogEntry içindeki jsonPayload bölümüne dahil edilir:

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

Parametreler

Ad	Tür	Açıklama
data	Object	günlüğe kaydedilecek nesne

Return

Logger: Zincirleme için Logger.

---

log(format, values)

Biçimlendirilmiş bir dizeyi, sağlanan biçim ve değerleri kullanarak günlük kaydı konsoluna yazar. Dize, bağımsız değişkenler listesindeki karşılık gelen değerlerle değiştirilen ve dizelere dönüştürülen birden fazla %s yer tutucu içerebilir.

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

Parametreler

Ad	Tür	Açıklama
format	String	%s bağımsız değişkenlerinin sayısı kadar %s örneği içeren bir biçim dizesivalues
values	Object...	biçim dizesine eklenecek değişken sayıda değer

Return

Logger: Zincirleme için Logger