Halaman ini diterjemahkan oleh Cloud Translation API.

Logging

Saat mengembangkan jenis aplikasi apa pun, sering kali Anda ingin mencatat informasi untuk membantu mendiagnosis kesalahan selama pengembangan, guna mengidentifikasi dan mendiagnosis masalah pelanggan, dan untuk tujuan lain.

Apps Script menyediakan tiga mekanisme yang berbeda untuk logging:

Log eksekusi Apps Script bawaan. Log ini ringan dan melakukan streaming secara real time, tetapi hanya bertahan dalam waktu singkat.
Antarmuka Cloud Logging di Developer Console, yang menyediakan log yang bertahan selama beberapa hari setelah pembuatannya.
Antarmuka Error Reporting di Developer Console, yang mengumpulkan dan mencatat error yang terjadi saat skrip berjalan.

Hal tersebut dijelaskan dalam bagian berikut. Selain mekanisme ini, Anda juga dapat membuat kode logger sendiri yang, misalnya, menulis informasi ke spreadsheet atau database JDBC logging.

Menggunakan log eksekusi Apps Script

Pendekatan dasar logging di Apps Script adalah menggunakan log eksekusi bawaan. Untuk melihat log ini, di bagian atas editor, klik Execution log. Saat Anda menjalankan fungsi atau menggunakan debugger, log akan di-streaming secara real time.

Anda dapat menggunakan layanan logging Logger atau console di log eksekusi bawaan.

Log ini ditujukan untuk pemeriksaan sederhana selama pengembangan dan proses debug, dan tidak bertahan lama.

Misalnya, pertimbangkan fungsi ini:

utils/logging.gs

Lihat di GitHub

/**
 * Logs Google Sheet information.
 * @param {number} rowNumber The spreadsheet row number.
 * @param {string} email The email to send with the row data.
 */
function emailDataRow(rowNumber, email) {
  console.log('Emailing data row ' + rowNumber + ' to ' + email);
  try {
    const sheet = SpreadsheetApp.getActiveSheet();
    const data = sheet.getDataRange().getValues();
    const rowData = data[rowNumber - 1].join(' ');
    console.log('Row ' + rowNumber + ' data: ' + rowData);
    MailApp.sendEmail(email, 'Data in row ' + rowNumber, rowData);
  } catch (err) {
    // TODO (developer) - Handle exception
    console.log('Failed with error %s', err.message);
  }
}

Saat skrip ini dijalankan dengan input "2" dan "john@example.com", log berikut akan ditulis:

[16-09-12 13:50:42:193 PDT] Mengirim data melalui baris data 2 ke john@example.com
[16-09-12 13:50:42:271 PDT] Data baris 2: Biaya 103,24

Cloud Logging

Apps Script juga menyediakan akses sebagian ke layanan Cloud Logging Google Cloud Platform (GCP). Saat Anda memerlukan logging yang berlangsung selama beberapa hari, atau memerlukan solusi logging yang lebih kompleks untuk lingkungan produksi multi-pengguna, Cloud Logging adalah pilihan yang lebih disukai. Lihat Kuota dan batas Cloud Logging untuk retensi data dan detail kuota lainnya.

Jika memerlukan lebih banyak kuota logging, Anda dapat mengirimkan permintaan kuota Google Cloud Platform. Ini mengharuskan Anda memiliki akses ke project Cloud Platform yang digunakan skrip.

Menggunakan Cloud Logging

Log cloud dilampirkan ke project Google Cloud yang terkait dengan Apps Script. Anda dapat melihat versi sederhana dari log ini di dasbor Apps Script.

Untuk memanfaatkan Cloud Logging sepenuhnya dan kemampuannya, gunakan project Google Cloud standar dengan project skrip Anda. Hal ini memungkinkan Anda mengakses log Cloud langsung di GCP Console dan memberi Anda lebih banyak opsi tampilan dan pemfilteran.

Saat mencatat, sebaiknya hindari mencatat informasi pribadi apa pun tentang pengguna, seperti alamat email. Log cloud secara otomatis diberi label dengan kunci pengguna aktif yang dapat Anda gunakan untuk menemukan pesan log pengguna tertentu jika diperlukan.

Anda dapat mencatat string, string yang diformat, dan bahkan objek JSON ke dalam log menggunakan fungsi yang disediakan oleh layanan console Apps Script.

Contoh berikut menunjukkan cara menggunakan layanan console untuk mencatat informasi di Cloud Operations ke dalam log.

utils/logging.gs

Lihat di GitHub

/**
 * Logs the time taken to execute 'myFunction'.
 */
function measuringExecutionTime() {
  // A simple INFO log message, using sprintf() formatting.
  console.info('Timing the %s function (%d arguments)', 'myFunction', 1);

  // Log a JSON object at a DEBUG level. The log is labeled
  // with the message string in the log viewer, and the JSON content
  // is displayed in the expanded log structure under "jsonPayload".
  const parameters = {
    isValid: true,
    content: 'some string',
    timestamp: new Date()
  };
  console.log({message: 'Function Input', initialData: parameters});
  const label = 'myFunction() time'; // Labels the timing log entry.
  console.time(label); // Starts the timer.
  try {
    myFunction(parameters); // Function to time.
  } catch (e) {
    // Logs an ERROR message.
    console.error('myFunction() yielded an error: ' + e);
  }
  console.timeEnd(label); // Stops the timer, logs execution duration.
}

Kunci pengguna aktif

Kunci pengguna aktif sementara menyediakan cara yang mudah untuk menemukan pengguna unik di entri Cloud Log tanpa mengungkapkan identitas pengguna tersebut. Kunci per skrip dan diubah sekitar sebulan sekali untuk memberikan keamanan tambahan jika pengguna mengungkapkan identitasnya kepada developer, misalnya saat melaporkan masalah.

Kunci pengguna aktif sementara lebih unggul daripada logging log, seperti alamat email karena:

Anda tidak perlu menambahkan apa pun ke logging; semuanya sudah tersedia.
Kebijakan ini tidak memerlukan otorisasi pengguna.
Melindungi privasi pengguna.

Untuk menemukan kunci pengguna aktif sementara di entri Cloud Log Anda, lihat log Cloud di Google Cloud Console. Anda hanya dapat melakukan hal ini jika project skrip menggunakan project Google Cloud standar yang dapat Anda akses. Setelah Anda membuka project Google Cloud di konsol, pilih entri log yang diinginkan dan luaskan untuk melihat metadata > label > script.googleapis.com/user_key.

Anda juga bisa mendapatkan kunci pengguna aktif sementara dengan memanggil Session.getTemporaryActiveUserKey() di skrip Anda. Salah satu cara untuk menggunakan metode ini adalah dengan menampilkan kunci kepada pengguna saat mereka menjalankan skrip Anda. Kemudian, pengguna dapat memilih untuk menyertakan kunci mereka saat melaporkan masalah untuk membantu Anda mengidentifikasi log yang relevan.

Logging pengecualian

Logging pengecualian mengirimkan pengecualian yang tidak tertangani di kode project skrip Anda ke Cloud Logging, bersama dengan pelacakan tumpukan.

Untuk melihat log pengecualian, ikuti langkah-langkah di bawah:

Buka project Apps Script.
Di sebelah kiri, klik Executions .
Di bagian atas, klik Tambahkan filter > Status.
Centang kotak Gagal dan Waktu habis.

Anda juga dapat melihat pengecualian yang dicatat dalam log di GCP console jika project skrip menggunakan project Google Cloud standar yang dapat Anda akses.

Mengaktifkan logging pengecualian

Logging pengecualian diaktifkan secara default untuk project baru. Untuk mengaktifkan logging pengecualian untuk project yang lebih lama, ikuti langkah-langkah di bawah:

Buka project skrip.
Di sebelah kiri, klik Project Settings .
Pilih kotak centang Catat pengecualian yang tidak tertangkap ke Cloud Operations.

Error Reporting

Logging pengecualian secara otomatis terintegrasi dengan Cloud Error Reporting, layanan yang menggabungkan dan menampilkan error yang dihasilkan dalam skrip Anda. Anda dapat melihat laporan error Cloud di Google Cloud Console. Jika Anda diminta "Menyiapkan Error Reporting" hal ini karena skrip Anda belum mencatat pengecualian apa pun. Tidak diperlukan penyiapan selain mengaktifkan logging pengecualian.

Persyaratan logging

Tidak ada persyaratan untuk menggunakan log eksekusi bawaan.

Anda dapat melihat versi log Cloud yang disederhanakan di dasbor Apps Script. Namun, untuk memaksimalkan Cloud Logging dan pelaporan error, Anda harus memiliki akses ke project GCP dari skrip tersebut. Hal ini hanya dapat dilakukan jika project skrip Anda menggunakan project Google Cloud standar.