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 yazmasına 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öntem | Dönüş türü | Kısa açıklama |
---|---|---|
clear() | void | Günlüğü temizler. |
getLog() | String | Geçerli günlükteki mesajların tam listesini döndürür. |
log(data) | Logger | Verileri günlüke yazar. |
log(format, values) | Logger | Sağ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ı konsolundan günlük
log(data)
Verileri günlüke yazar. Veriler bir dize, JavaScript nesnesi veya message
özelliğine sahip 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
Ad | Tür | Açıklama |
---|---|---|
data | Object | Gü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 tutucusu 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
Ad | Tür | Açıklama |
---|---|---|
format | String | values bağımsız değişkeni sayısı kadar %s örneği içeren bir biçim dizesi |
values | Object... | Biçim dizesine eklenecek değişken sayıda değer |
Return
Logger
: Zincirleme için Logger