Ringkasan metrik berbasis log

Halaman ini menyediakan ringkasan konseptual tentang metrik berbasis log.

Metrik berbasis log mengambil data metrik dari isi entri log. Misalnya, Anda dapat menggunakan metrik berbasis log untuk menghitung jumlah entri log yang berisi pesan tertentu atau untuk mengekstrak informasi latensi yang dicatat dalam entri log. Anda dapat menggunakan metrik berbasis log dalam diagram Cloud Monitoring dan kebijakan pemberitahuan.

Sumber metrik berbasis log

Anda dapat menggunakan metrik yang ditentukan oleh Cloud Logging untuk mengumpulkan informasi penggunaan umum, dan menentukan metrik berbasis log Anda sendiri untuk mengambil informasi khusus untuk aplikasi atau bisnis Anda.

Metrik berbasis log dapat diterapkan dalam satu project Google Cloud atau dalam bucket log. Anda tidak dapat membuat metrik berbasis log untuk resource Google Cloud lainnya seperti organisasi atau akun Penagihan Cloud.

Untuk mengetahui informasi tentang perbedaan antara metrik berbasis log berbasis project dan metrik berbasis log berbasis bucket, lihat Metrik berbasis log dengan cakupan bucket.

Metrik yang ditentukan sistem

Logging menyediakan kumpulan metrik untuk nilai penggunaan seperti jumlah entri log yang disimpan dalam bucket log di project Anda, atau jumlah byte yang telah Anda ekspor. Untuk mengetahui daftar lengkap metrik yang ditentukan sistem, lihat Metrik Google Cloud: logging.

Metrik yang ditentukan pengguna

Anda dapat membuat metrik berbasis log buatan pengguna untuk melacak metrik lain yang penting untuk project Anda. Misalnya, Anda dapat membuat metrik berbasis log untuk menghitung jumlah entri log yang cocok dengan filter tertentu.

Secara default, metrik berbasis log yang ditetapkan pengguna dihitung dari semua log yang diterima oleh Logging API untuk project Google Cloud, terlepas dari filter penyertaan atau filter pengecualian yang mungkin berlaku untuk project Google Cloud.

Anda juga dapat membuat metrik berbasis log buatan pengguna untuk bucket log tertentu dalam project Google Cloud. Metrik berbasis log dengan cakupan bucket dihitung dari semua log yang ditujukan untuk bucket, dari mana pun asalnya. Untuk informasi lebih lanjut, lihat Metrik berbasis log di bucket log.

Jenis data untuk metrik berbasis log

Metrik berbasis log dapat mengekstrak data dari log untuk membuat metrik dari jenis berikut:

  • Penghitung: metrik ini menghitung jumlah entri log yang cocok dengan filter yang ditentukan dalam periode tertentu. Gunakan penghitung jika Anda ingin melacak berapa kali nilai atau string muncul di log.
  • Distribusi: metrik ini juga menghitung nilai, tetapi mengumpulkan jumlah dalam rentang nilai (bucket histogram). Gunakan distribusi jika Anda ingin mengekstrak nilai seperti latensi.
  • Boolean: metrik ini merekam apakah entri log cocok dengan filter yang ditentukan atau tidak.

Metrik berbasis log yang ditentukan pengguna dapat berupa jenis metrik penghitung atau distribusi. Sebagian besar metrik berbasis log yang ditentukan sistem adalah penghitung, tetapi sebagian lainnya berjenis boolean. Karakteristik penghitung dan distribusi dijelaskan secara lebih mendetail di bagian berikutnya.

Data untuk metrik berbasis log yang ditentukan pengguna hanya berasal dari entri log yang diterima setelah metrik dibuat. Metrik tidak terisi secara surut dengan data dari entri log yang sudah ada di Logging.

Metrik berbasis log sistem dihitung hanya dari log yang disertakan. Metrik berbasis log yang ditentukan pengguna dihitung dari log yang disertakan dan dikecualikan.

Logging mengumpulkan informasi untuk metrik berbasis log setiap kali log menerima entri log yang cocok. Logging menulis titik data baru ke deret waktu metrik dengan kecepatan 1 titik data per menit, sehingga data tersedia untuk Cloud Monitoring.

Setiap titik data dalam deret waktu metrik berbasis log hanya menunjukkan informasi tambahan (delta) yang diterima sejak titik data sebelumnya.

Bagian berikut menjelaskan karakteristik metrik jenis penghitung dan jenis distribusi.

Metrik penghitung

Metrik penghitung menghitung jumlah entri log yang cocok dengan filter tertentu. Misalnya, Anda dapat melakukan hal berikut:

  • Menghitung entri log yang berisi pesan error tertentu.
  • Hitung berapa kali setiap pengguna memanggil operasi, dengan mencari pesan log yang cocok dengan pola ini:

    ... user USERNAME called OPERATION ...

    Dengan mengekstrak USERNAME dan OPERATION dan menggunakannya sebagai nilai untuk dua label, Anda nanti dapat bertanya, "Berapa kali sally memanggil operasi update?", "Berapa banyak orang yang memanggil operasi read?", "Berapa kali george memanggil operasi?", dan seterusnya.

Untuk informasi selengkapnya, lihat Mengonfigurasi metrik penghitung.

Metrik distribusi

Metrik distribusi mengumpulkan data numerik dari entri log yang cocok dengan filter. Metrik berisi deret waktu objek distribusi, yang masing-masing berisi hal berikut:

  • Hitungan jumlah nilai dalam distribusi.
  • Nilai rerata.
  • Jumlah deviasi kuadrat: Sumi=1..n(xi–mean)2
  • Kumpulan bucket histogram dengan jumlah nilai di setiap bucket. Anda dapat menggunakan tata letak bucket default atau memilih tata letak Anda sendiri.

Penggunaan metrik distribusi yang umum adalah untuk melacak latensi. Saat setiap entri log diterima, nilai latensi diekstrak dari suatu tempat dalam entri log dan ditambahkan ke distribusi. Secara berkala, distribusi yang terakumulasi ditulis ke Cloud Monitoring.

Untuk informasi tentang distribusi, termasuk formatnya dalam deret waktu dan cara divisualisasikan, lihat Membuat diagram metrik distribusi.

Untuk informasi tentang pembuatan metrik berbasis log distribusi, lihat Mengonfigurasi metrik distribusi.

Jenis resource

Sebaiknya metrik berbasis log Anda menentukan satu jenis resource. Spesifikasi ini memastikan bahwa data deret waktu yang dihasilkan untuk metrik berbasis log Anda cocok dengan model data yang diharapkan oleh Cloud Monitoring. Hal ini juga menyederhanakan proses pembuatan diagram dan kebijakan pemberitahuan, karena tidak ada ambiguitas terkait data deret waktu mana yang dipetakan atau dipantau.

Pertimbangkan metrik berbasis log dengan filter berikut:

severity>="ERROR"
resource.type="gce_instance"

Cloud Monitoring mengetahui bahwa data ini ditujukan untuk instance VM Compute Engine. Oleh karena itu, saat Anda membuat diagram untuk instance VM, metrik berbasis log akan dicantumkan sebagai opsi di menu. Saat Anda membuat diagram untuk jenis resource yang berbeda, metrik berbasis log Anda tidak akan tercantum sebagai opsi.

Jika Anda membuat metrik berbasis log tanpa menentukan jenis resource, Monitoring akan mencantumkan metrik berbasis log sebagai opsi untuk beberapa jenis resource, meskipun Anda tidak menghitung entri dari resource tersebut.

Label

Metrik berbasis log dapat memiliki label, yang memungkinkan beberapa deret waktu dikumpulkan untuk metrik. Nilai untuk label diekstrak dari kolom dalam entri log yang cocok. Logging mencatat deret waktu terpisah untuk setiap kombinasi nilai label.

Semua metrik berbasis log memberikan label log default. Label ini menyimpan nilai bagian LOG_ID dari kolom logName dalam entri log, misalnya, cloudresourcemanager.googleapis.com%2Factivity.

Metrik berbasis log sistem memiliki label yang telah ditentukan dan tidak dapat diubah. Namun, Anda dapat menyesuaikan label untuk metrik yang ditentukan pengguna. Misalnya, Anda dapat menggunakan label dalam metrik berbasis log untuk mencatat folder atau organisasi tempat entri log berasal, meskipun metrik berbasis log dengan cakupan bucket tidak dapat dibuat untuk folder atau organisasi. Untuk mengetahui informasi selengkapnya, lihat Label metrik berbasis log.

Diagram dan pemberitahuan di Cloud Monitoring

Anda dapat menggunakan metrik berbasis log yang ditentukan sistem dan buatan pengguna di Cloud Monitoring untuk membuat diagram dan kebijakan pemberitahuan. Untuk mengetahui informasi selengkapnya, lihat Menampilkan metrik berbasis log diagram dan daftar serta Memberikan pemberitahuan tentang metrik berbasis log.

Dalam Cloud Monitoring, metrik berbasis log menggunakan pola penamaan berikut:

  • Sistem: logging.googleapis.com/SYSTEM_METRIC_NAME
  • Buatan pengguna: logging.googleapis.com/user/USER_METRIC_NAME

Perhatikan bahwa metrik berbasis log yang ditentukan pengguna menyertakan string user.

Visibilitas ke cakupan metrik Monitoring

Metrik berbasis log diserap oleh Cloud Monitoring, dan visibilitas data metrik ke project Google Cloud ditentukan oleh cakupan metrik. Cakupan metrik adalah daftar project yang dipantau oleh project yang menghosting cakupan metrik; project hosting-nya disebut project cakupan.

Secara default, setiap project menghosting cakupan metrik yang hanya mencakup dirinya sendiri, sehingga project adalah project pencakupan untuk project itu sendiri. Oleh karena itu, metrik Anda, termasuk metrik berbasis log, hanya dapat dilihat oleh project Google Cloud Anda.

Anda juga dapat membuat cakupan metrik multi-project untuk project pencakupan. Dengan cakupan metrik multi-project, project pencakupan dapat melihat metrik dari semua project dalam cakupan metrik. Apa yang terlihat oleh masing-masing project dalam cakupan metrik multi-project ditentukan oleh cakupan metrik yang dihosting oleh masing-masing project tersebut. Fakta bahwa dua project berada dalam cakupan metrik multi-project tidak berarti bahwa setiap project memiliki akses ke data metrik atau konfigurasi dalam project lainnya.

Satu project juga dapat muncul dalam beberapa cakupan metrik. Metrik dari project tersebut dapat dilihat oleh project pencakupan dari setiap cakupan metrik tersebut.

Metrik, termasuk metrik berbasis log, ditetapkan dalam project tertentu. Saat project tersebut muncul dalam beberapa cakupan metrik, metrik akan terlihat oleh project selain project tempat metrik tersebut ditetapkan. Untuk mengetahui informasi tentang cara cakupan metrik dan metrik berbasis log dengan cakupan bucket berinteraksi, lihat Cakupan project dan metrik.

Untuk informasi selengkapnya tentang cakupan metrik, termasuk cakupan metrik multi-project, dan tentang pencakupan project, lihat artikel berikut:

Harga

Semua metrik berbasis log yang ditentukan pengguna adalah kelas metrik kustom Cloud Monitoring dan dapat dikenakan biaya. Untuk mengetahui informasi harga, lihat Harga Cloud Logging: Metrik berbasis log.

Kuota

Untuk mengetahui informasi tentang kuota dan batas yang terkait dengan metrik berbasis log yang ditentukan pengguna, lihat Kuota dan batas.

Pemecahan masalah

Jika Anda mengalami masalah saat menggunakan metrik berbasis log, lihat Memecahkan masalah metrik berbasis log.