Anda dapat menulis log ke Cloud Logging dari aplikasi Python dengan menggunakan pengendali logging Python standar, atau dengan menggunakan library klien Cloud Logging API untuk Python secara langsung. Saat menggunakan pengendali logging Python standar, Anda harus melampirkan pengendali Cloud Logging ke pengendali root Python. Dokumen ini mengilustrasikan pendekatan tersebut.
Sebelum memulai
- Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
Aktifkan Cloud Logging API.
Peran yang diperlukan untuk mengaktifkan API
Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (
roles/serviceusage.serviceUsageAdmin), yang berisi izinserviceusage.services.enable. Pelajari cara memberikan peran. -
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
Aktifkan Cloud Logging API.
Peran yang diperlukan untuk mengaktifkan API
Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (
roles/serviceusage.serviceUsageAdmin), yang berisi izinserviceusage.services.enable. Pelajari cara memberikan peran. - Siapkan lingkungan Anda untuk pengembangan Python.
Instal library
Untuk menginstal library Cloud Logging untuk Python, lihat Menginstal library klien untuk Python. Library ini memungkinkan Anda memasang pengendali Cloud Logging ke pengendali root Python standar. Anda juga dapat menggunakan library ini untuk mengirim permintaan API ke Cloud Logging.
Untuk mengetahui informasi selengkapnya tentang penginstalan, lihat dokumentasi untuk library Cloud Logging untuk Python. Anda juga dapat melaporkan masalah menggunakan issue tracker.
Menulis log dengan pengendali logging Python standar
Untuk mengetahui informasi tentang cara menggunakan handler logging standar, lihat Konfigurasi lanjutan berbasis kode.
Menulis log dengan library klien Cloud Logging
Untuk mengetahui informasi tentang cara menggunakan library klien Cloud Logging untuk Python secara langsung, lihat Library Klien Cloud Logging.
Jalankan di Google Cloud
Agar aplikasi dapat menulis log menggunakan library Cloud Logging untuk Python, akun layanan untuk resource pokok harus memiliki peran IAM Logs Writer (roles/logging.logWriter).
Sebagian besar Google Cloud lingkungan otomatis mengonfigurasi akun layanan default agar memiliki peran ini.
App Engine
Cloud Logging diaktifkan secara otomatis untuk App Engine, dan akun layanan default aplikasi Anda memiliki izin IAM secara default untuk menulis entri log.
Untuk mengetahui informasi selengkapnya, lihat Menulis dan melihat log.
Google Kubernetes Engine (GKE)
GKE secara otomatis memberikan peran IAM Logs Writer (roles/logging.logWriter) kepada akun layanan default.
Jika Anda menggunakan
Workload Identity Federation untuk GKE
dengan akun layanan default ini untuk mengizinkan workload mengakses API
Google Cloud tertentu, tidak ada konfigurasi tambahan yang diperlukan.
Namun, jika Anda menggunakan Workload Identity Federation untuk GKE dengan akun layanan IAM kustom, pastikan akun layanan kustom tersebut memiliki peran Logs Writer (roles/logging.logWriter).
Jika perlu, Anda juga dapat menggunakan perintah berikut untuk menambahkan cakupan akses logging.write
saat membuat cluster:
gcloud container clusters create example-cluster-name \
--scopes https://www.googleapis.com/auth/logging.write
Compute Engine
Saat menggunakan instance VM Compute Engine, tambahkan cakupan akses cloud-platform
ke setiap instance. Saat membuat instance baru melalui
Google Cloud konsol, Anda dapat melakukannya di bagian Akses API dan identitas
pada panel Buat Instance. Gunakan akun layanan default Compute Engine atau akun layanan lain pilihan Anda, lalu pilih Izinkan akses penuh ke semua Cloud API di bagian Identity and API access. Akun layanan mana pun yang Anda pilih, pastikan akun tersebut telah diberi peran Logs Writer di bagian IAM & Admin pada konsolGoogle Cloud .
Menjalankan secara lokal dan di tempat lain
Untuk menggunakan library Cloud Logging untuk Python di luar Google Cloud, termasuk menjalankan library di workstation Anda sendiri, di komputer pusat data Anda, atau di instance VM penyedia cloud lain, Anda harus menyiapkan Kredensial Default Aplikasi (ADC) di lingkungan lokal untuk mengautentikasi library Cloud Logging untuk Python.
Untuk mengetahui informasi selengkapnya, lihat Menyiapkan ADC untuk lingkungan lokal atau penyedia cloud lainnya.
Melihat log
Di konsol Google Cloud , buka Logs Explorer:
Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Logging.
Di Logs Explorer, Anda harus menentukan satu atau beberapa resource, tetapi pemilihan resource mungkin tidak jelas. Berikut beberapa tips untuk membantu Anda memulai:
Jika Anda men-deploy aplikasi ke App Engine atau menggunakan library khusus App Engine, setel resource Anda ke Aplikasi GAE.
Jika Anda men-deploy aplikasi di Compute Engine, tetapkan resource ke Instance VM GCE.
Jika Anda men-deploy aplikasi di Google Kubernetes Engine, konfigurasi logging cluster Anda akan menentukan jenis resource entri log. Untuk mengetahui pembahasan mendetail tentang solusi Legacy Google Cloud Observability dan Google Cloud Observability Kubernetes Monitoring, serta pengaruh opsi tersebut terhadap jenis resource, lihat Bermigrasi ke Google Cloud Observability Kubernetes Monitoring.
Jika aplikasi Anda menggunakan Cloud Logging API secara langsung, resource bergantung pada API dan konfigurasi Anda. Misalnya, di aplikasi, Anda dapat menentukan resource atau menggunakan resource default.
Jika Anda tidak melihat log apa pun di Logs Explorer, untuk melihat semua entri log, beralihlah ke mode kueri lanjutan dan gunakan kueri kosong.
- Untuk beralih ke mode kueri lanjutan, klik menu (▾) di bagian atas Logs Explorer, lalu pilih Konversikan ke filter lanjutan.
- Hapus konten yang muncul di kotak filter.
- Klik Kirim Filter.
Anda dapat memeriksa setiap entri untuk mengidentifikasi resource Anda.
Untuk mengetahui informasi tambahan, lihat Menggunakan Logs Explorer.