Class Logger

Günlük Kaydedici

Bu sınıf, geliştiricinin komut dosyası bir standart Cloud projesiyle ilişkilendirilmişse yürütme günlüğüne ve Google Cloud Günlük'e yazmaya olanak tanır. Bu sınıf, Cloud Logging'da 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 değerini kullanın.

Yöntemler

YöntemDönüş türüKısa açıklama
clear()voidGünlüğü temizler.
getLog()StringGeçerli günlükteki mesajların tam listesini döndürür.
log(data)LoggerVerileri günlüke yazar.
log(format, values)LoggerSağlanan biçimi ve değerleri kullanarak günlük kaydı konsoluna biçimlendirilmiş bir dize yazar.

Ayrıntılı dokümanlar

clear()

Günlüğü temizler.


getLog()

Geçerli günlükteki mesajların tam listesini döndürür. Bu yöntem, komut dosyası yürütülmesi sırasında oluşturulan günlük çıkışının tamamı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üke yazar. Veriler bir dize, JavaScript nesnesi veya message mülkü 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 bir message özelliği içeriyorsa bu özellik günlük mesajı olarak kullanılır. Aksi takdirde, nesneyi bir dizeye dönüştürmek için toString() yöntemi çağrılır. JSON olarak serileştirilebilir diğer tüm özellikler, aşağıdaki örneğe benzer şekilde LogEntry içindeki jsonPayload kapsamında yer alır:

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

AdTürAçıklama
dataObjectGünlüğe kaydedilecek nesne

Return

Logger: Zincirleme için Logger.


log(format, values)

Sağlanan biçimi ve değerleri kullanarak günlük kaydı konsoluna biçimlendirilmiş bir dize yazar. Dize, birden fazla %s yer tutucu içerebilir. Bu yer tutucular, bağımsız değişken listesinden alınan ve dizeye dönüştürülen karşılık gelen değerlerle değiştirilir.

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

AdTürAçıklama
formatStringvalues bağımsız değişkeni sayısı kadar %s örneği içeren bir biçim dizesi
valuesObject...Biçim dizesine eklenecek değişken sayıda değer

Return

Logger: Zincirleme için Logger