Aktifkan logging

Library ini menyediakan logging serbaguna untuk interaksi Google Ads API. Anda dapat mengambil:

  • Informasi mendetail: Permintaan lengkap yang dikirim ke API dan respons yang diterima.
  • Ringkasan singkat: Ringkasan umum interaksi API.

Anda dapat mengontrol setelan logging ini dengan dua cara:

  • Konfigurasi library klien: Gunakan opsi konfigurasi khusus library di file google-ads.yaml atau variabel lingkungan Anda.
  • Secara terprogram dengan Python: Gunakan framework logging bawaan Python untuk kontrol langsung.

Mengonfigurasi melalui google-ads.yaml

Logging dikonfigurasi secara otomatis saat instance GoogleAdsClient diinisialisasi (misalnya, saat Anda memanggil load_from_storage). Saat inisialisasi, library:

Misalnya, Anda dapat menambahkan bagian logging ke file google-ads.yaml:

logging:
  version: 1
  disable_existing_loggers: false
  formatters:
    default_fmt:
      format: '[%(asctime)s - %(levelname)s] %(message).5000s'
      datefmt: '%Y-%m-%d %H:%M:%S'
  handlers:
    default_handler:
      class: logging.StreamHandler
      formatter: default_fmt
  loggers:
    '':
      handlers: [default_handler]
      level: INFO

Mengonfigurasi secara terprogram

Saat menggunakan library sebagai paket yang diinstal tanpa bagian logging dalam file konfigurasi, Anda dapat mengintegrasikan logging-nya dengan penyiapan logging aplikasi secara terprogram. Lampirkan pengendali logging ke instance logger library (google.ads.googleads.client) menggunakan addHandler dan tetapkan level log target:

import logging
import sys

# Retrieve the library's logger instance.
logger = logging.getLogger("google.ads.googleads.client")

# Direct logs to standard output (stdout).
logger.addHandler(logging.StreamHandler(sys.stdout))

# Set the log level to DEBUG to view detailed messages.
logger.setLevel(logging.DEBUG)

Jika Anda lebih suka mengirim log ke error standar (stderr), yang sering digunakan untuk pesan error dan peringatan, teruskan sys.stderr ke logging.StreamHandler:

import logging
import sys

logger = logging.getLogger("google.ads.googleads.client")
logger.addHandler(logging.StreamHandler(sys.stderr))
logger.setLevel(logging.WARNING)

Level log

Klien menghasilkan log pada beberapa tingkat keparahan, dan Anda dapat mengonfigurasi logger untuk melihat beberapa atau semua hal berikut:

Level Permintaan berhasil Permintaan gagal
DEBUG Log mendetail dengan objek permintaan dan respons lengkap sebagai JSON. Log mendetail dengan objek permintaan dan pengecualian lengkap sebagai JSON.
INFO Ringkasan singkat dengan kolom permintaan dan respons tertentu. Log mendetail dengan objek permintaan dan pengecualian lengkap sebagai JSON.
WARNING Tidak ada Ringkasan singkat dengan informasi permintaan tertentu, status pengecualian, dan pesan error.

Karena framework logging Python mengabaikan pesan log yang tidak terlalu parah dibandingkan level yang dikonfigurasi, menetapkan level ke WARNING hanya akan menampilkan pesan singkat untuk permintaan yang gagal, sedangkan menetapkan level ke DEBUG akan menampilkan semua jenis log dalam tabel.

Mencatat ke file

Anda dapat menulis log ke file secara terprogram di Python atau dengan mengalihkan output dari command line.

Mencatat ke file di Python

Untuk menulis log langsung ke file dari Python, lampirkan logging.FileHandler ke logger klien:

import logging

logger = logging.getLogger("google.ads.googleads.client")
file_handler = logging.FileHandler("google_ads.log")
logger.addHandler(file_handler)
logger.setLevel(logging.INFO)

Mengalihkan output menggunakan shell

Saat menjalankan contoh skrip seperti get_campaigns.py dari command line, Anda dapat mengalihkan output log konsol ke file menggunakan shell sistem operasi Anda.

Untuk menyimpan output standar ke file (menimpa file yang ada):

python get_campaigns.py -c $CUSTOMER_ID > campaign_logs.txt

Untuk menambahkan output standar ke file yang ada:

python get_campaigns.py -c $CUSTOMER_ID >> campaign_logs.txt

Untuk menyimpan output standar dan error standar (untuk error dan peringatan) ke file yang sama:

python get_campaigns.py -c $CUSTOMER_ID > all_logs.txt 2>&1

Atau, di Bash 4+:

python get_campaigns.py -c $CUSTOMER_ID &> all_logs.txt

Interseptor gRPC kustom

Library klien Python menggunakan interseptor gRPC untuk mengakses dan mencatat detail permintaan dan respons ke dalam log. Anda dapat menyiapkan logging kustom Anda sendiri dengan membuat interceptor gRPC dengan logika kustom. Lihat Panduan logging untuk mengetahui detail selengkapnya dan contoh interseptor logging kustom.