Filter pengecualian memungkinkan Anda mengontrol volume log Google Kubernetes Engine (GKE) yang diserap oleh Cloud Logging sekaligus tetap menyediakan logging panjang untuk proses debug. Anda dapat menggunakan filter pengecualian untuk mengecualikan entri log yang cocok agar tidak diserap oleh Cloud Logging atau agar tidak dirutekan ke tujuan sink.
Buat filter pengecualian menggunakan bahasa kueri Logging.
Entri log dikecualikan setelah diterima oleh
Logging API, sehingga entri log ini menggunakan
kuota entries.write
API. Anda tidak dapat mengurangi
jumlah panggilan API entries.write
dengan
mengecualikan entri log.
Entri log yang dikecualikan tidak tersedia di Logs Explorer atau di Error Reporting.
Untuk informasi tentang cara melihat data penyerapan, lihat Melihat penggunaan mendetail di Metrics Explorer.
Sebelum memulai
Sebelum memulai, pastikan Anda telah menjalankan tugas berikut:
- Aktifkan Google Kubernetes Engine API. Aktifkan Google Kubernetes Engine API
- Jika ingin menggunakan Google Cloud CLI untuk tugas ini,
instal lalu
lakukan inisialisasi
gcloud CLI. Jika sebelumnya Anda telah menginstal gcloud CLI, dapatkan versi terbaru dengan menjalankan
gcloud components update
.
- Pastikan Anda memiliki project Google Cloud dengan log yang dapat Anda lihat di Logs Explorer.
Izin
Pastikan Anda memiliki salah satu peran IAM berikut untuk project Google Cloud sumber tempat Anda merutekan log.
- Pemilik (
roles/owner
) - Logging Admin (
roles/logging.admin
) - Logs Configuration Writer (
roles/logging.configWriter
)
Izin yang terdapat dalam peran ini memungkinkan Anda membuat, menghapus, atau mengubah sink. Untuk informasi tentang cara menetapkan peran IAM, lihat Panduan kontrol akses Logging.
Menambahkan filter pengecualian
Langkah-langkah berikut menjelaskan cara menambahkan filter pengecualian Cloud Logging yang mengecualikan log dari penyerapan ke bucket Cloud Logging Default
.
Di konsol Google Cloud, buka halaman Logs Router:
Temukan baris dengan sink
_Default
, luaskan opsi Actions, lalu klik Edit sink.Di Choose logs to filter out of sink, untuk Build an exclusion filter, klik
Add exclusion.Masukkan nama untuk filter pengecualian Anda.
Di bagian Build an exclusion filter, masukkan kriteria filter. Misalnya, Anda dapat mengecualikan entri log untuk cluster, atau entri log tertentu untuk penampung.
Mengecualikan semua entri log dari cluster tertentu:
resource.labels.cluster_name="CLUSTER_NAME"
Kecualikan entri log dengan keparahan log
DEFAULT
,DEBUG
,INFO
, atauNOTICE
untuk penampung tertentu di cluster tertentu:resource.type="k8s_container" resource.labels.container_name="CONTAINER_NAME" resource.labels.cluster_name="CLUSTER_NAME" severity=(DEFAULT OR DEBUG OR INFO OR NOTICE)
Klik Update sink.
Sink _Default
kini dikonfigurasi untuk mengecualikan log dengan filter yang Anda tambahkan.
Langkah berikutnya
- Pelajari filter pengecualian lebih lanjut.