Class Logger

Logger

このクラスを使用すると、スクリプトが a 標準 Cloud プロジェクトに関連付けられている場合、デベロッパーは実行ログとGoogle Cloud Loggingに書き込むことができます。このクラスは、Cloud Logging での構造化ロギングと jsonPayload のサポートに適しています。時間ベースのロギングには console を使用します。

メソッド

メソッド戻り値の型概要
clear()voidログをクリアします。
getLog()String現在のログのメッセージの完全なリストを返します。
log(data)Loggerデータをログに書き込みます。
log(format, values)Logger指定された形式と値を使用して、書式設定された文字列をロギング コンソールに書き込みます。

詳細なドキュメント

clear()

ログをクリアします。

getLog()

現在のログのメッセージの完全なリストを返します。このメソッドを使用すると、スクリプトの実行中に生成されたログ出力全体を保存またはメールで送信できます。 

// 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 プロパティが含まれている場合、そのプロパティはログメッセージとして使用されます。それ以外の場合は、toString() メソッドが呼び出されてオブジェクトが文字列に変換されます。JSON シリアル化可能な他のすべてのプロパティは、次の例のように、 jsonPayload の LogEntry の一部として含まれます。 

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

パラメータ

名前タイプ説明
dataObjectログに記録するオブジェクト

戻る

Logger - チェーン用の 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);

パラメータ

名前タイプ説明
formatString引数の数と同じ数の %s インスタンスを含む書式設定文字列values
valuesObject...書式設定文字列に挿入する可変数の値

戻る

Logger - チェーン用の Logger