Ringkasan metrik berbasis log

Halaman ini menyediakan ringkasan konseptual tentang metrik berbasis log.

Metrik berbasis log mengambil data metrik dari entri log yang berasal dari project Google Cloud Anda atau yang dirutekan ke project Google Cloud Anda. 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 dan kebijakan pemberitahuan Cloud Monitoring.

Sumber metrik berbasis log

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

Metrik berbasis log dapat berlaku 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 cakupan bucket.

Metrik yang ditentukan sistem

Logging menyediakan sekumpulan 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 yang ditentukan 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 yang diberikan.

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

Anda juga dapat membuat metrik berbasis log yang ditentukan pengguna untuk bucket log tertentu dalam project Google Cloud. Metrik berbasis log cakupan bucket dihitung dari semua log yang ditujukan untuk bucket, dari mana pun asalnya. Untuk informasi selengkapnya, 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 menangkap 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 lagi berjenis boolean. Karakteristik penghitung dan distribusi akan 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 retroaktif 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 tersebut menerima entri log yang cocok. Logging akan 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 mewakili 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 lalu menggunakannya sebagai nilai untuk dua label, Anda nantinya dapat bertanya, "Berapa kali sally memanggil operasi update?", "Berapa banyak orang yang memanggil operasi read?", "Berapa kali george melakukan panggilan 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 {i>mean<i}.
Jumlah deviasi kuadrat: Sum_i=1..n(x_i–rata-rata)²
Kumpulan bucket histogram dengan jumlah nilai di setiap bucket. Anda dapat menggunakan tata letak bucket default atau memilih tata letak Anda sendiri.

Penggunaan umum untuk metrik distribusi 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 akan ditulis ke Cloud Monitoring.

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

Untuk informasi tentang cara membuat metrik berbasis log distribusi, lihat Mengonfigurasi metrik distribusi.

Jenis resource

Sebaiknya metrik berbasis log 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 mengenali bahwa data ini adalah untuk instance VM Compute Engine. Oleh karena itu, saat Anda membuat diagram untuk instance VM, metrik berbasis log Anda akan dicantumkan sebagai opsi di menu. Saat Anda membuat diagram untuk jenis resource yang berbeda, metrik berbasis log tidak akan dicantumkan 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 akan memisahkan deret waktu untuk setiap kombinasi nilai label.

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

Metrik berbasis log sistem memiliki label telah ditentukan yang 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 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 pengguna di Cloud Monitoring untuk membuat diagram dan kebijakan pemberitahuan. Untuk mengetahui informasi selengkapnya, lihat artikel Menampilkan daftar dan membuat diagram metrik berbasis log serta Membuat pemberitahuan berdasarkan 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 ini disebut project pencakupan.

Secara default, setiap project menghosting cakupan metrik yang hanya menyertakan cakupan metrik itu sendiri, sehingga project merupakan project pencakupan untuk dirinya 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 setiap project tersebut. Fakta bahwa dua project berada dalam cakupan metrik multi-project, bukan berarti bahwa setiap project memiliki akses ke data metrik atau konfigurasi dalam project lain.

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. Jika project tersebut muncul dalam beberapa cakupan metrik, metrik akan terlihat oleh project selain yang ditetapkan untuknya. Untuk informasi tentang cara cakupan metrik dan metrik berbasis log 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 class metrik kustom Cloud Monitoring dan dapat dikenakan biaya. Untuk mengetahui informasi harga, lihat artikel 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.