Kemampuan observasi di Cloud Tasks

Google Cloud Observability menyediakan alat pemantauan, logging, dan diagnostik. Alat ini dapat membantu Anda memantau dan menganalisis aktivitas dan pertumbuhan Cloud Tasks, serta memahami perilaku, kondisi, dan performa aplikasi Anda.

Secara default, Cloud Tasks dikonfigurasi untuk melakukan hal berikut:

  • Mengirim log audit data dan sistem ke Cloud Logging. Anda dapat menggunakan log yang dikumpulkan untuk men-debug, memecahkan masalah, dan mendapatkan insight tentang aplikasi Anda.
  • Mengirim metrik sistem dan resource ke Cloud Monitoring. Anda dapat menggunakan metrik yang dikumpulkan untuk memantau kondisi dan performa, mengidentifikasi tren dan masalah, serta memberi tahu tentang perubahan perilaku.

Mengirim log audit ke Cloud Logging

Cloud Tasks mengirimkan jenis data log audit berikut ke Cloud Logging:

Log audit Akses Data dinonaktifkan secara default karena log audit ini dapat menjadi cukup besar.

Untuk informasi selengkapnya, lihat Logging audit Cloud Tasks.

Menggunakan Cloud Logging dengan antrean

Anda dapat menggunakan Cloud Logging dengan antrean Cloud Tasks. Operasi berikut dicatat ke dalam log:

  • Operasi tugas:
    • CreateTask
    • DeleteTask
  • Mencoba operasi:
    • AttemptDispatch
    • AttemptResponse

Aktifkan logging

Anda dapat mengaktifkan logging menggunakan Konsol Google Cloud atau Google Cloud CLI.

Konsol

  1. Di konsol Google Cloud, buka halaman Cloud Tasks > Antrean.

    Buka Antrean

  2. Klik nama antrean yang ingin Anda aktifkan logging-nya.

  3. Di halaman Queue details, klik tab Logs.

  4. Klik Enable logs, lalu klik Enable untuk mengonfirmasi.

    screenshot

gcloud

Untuk mengaktifkan logging, Anda dapat menggunakan perintah gcloud tasks queues create atau gcloud tasks queues update.

gcloud tasks queues create QUEUE_ID \
    --log-sampling-ratio=LOG_SAMPLING_RATION

atau

gcloud tasks queues update QUEUE_ID \
    --log-sampling-ratio=LOG_SAMPLING_RATIO

Ganti kode berikut:

  • QUEUE_ID: ID antrean Anda
  • LOG_SAMPLING_RATIO: fraksi operasi yang dicatat ke dalam log. Nilai apa pun antara 1.0 dan 0.0 akan mencatat pecahan operasi tersebut. Untuk mencatat semua operasi, tetapkan ke 1.0. Untuk tidak mencatat operasi, tetapkan ke 0.0 (ini adalah setelan default).

Menonaktifkan logging

Anda dapat menonaktifkan logging menggunakan Konsol Google Cloud atau Google Cloud CLI.

Konsol

  1. Di konsol Google Cloud, buka halaman Cloud Tasks > Antrean.

    Buka Antrean

  2. Klik nama antrean yang logging-nya ingin Anda nonaktifkan.

  3. Di halaman Queue details, klik tab Logs.

  4. Klik ikon elipsis > Nonaktifkan log. Untuk mengonfirmasi, klik Disable.

    screenshot

gcloud

Untuk menonaktifkan logging, gunakan perintah gcloud tasks queues update dan tetapkan flag log-sampling-ratio ke 0.0.

gcloud tasks queues update QUEUE_ID \
    --log-sampling-ratio=0.0

Ganti QUEUE_ID dengan ID antrean Anda.

Membuat kueri dan melihat log

Anda dapat menggunakan alat berikut untuk melihat dan menganalisis log:

  • Logs Explorer dirancang untuk membantu Anda memecahkan masalah dan menganalisis performa layanan dan aplikasi. Untuk mempelajari cara melihat log di Logs Explorer, ikuti petunjuk di Melihat log menggunakan Logs Explorer.
  • Log Analytics dirancang untuk menjalankan kueri guna menganalisis log Anda, lalu melihat atau membuat diagram hasilnya. Untuk mempelajari cara menggunakan Log Analytics, ikuti petunjuk di Mengkueri dan menganalisis log dengan Log Analytics.

Anda dapat memfilter log Cloud Tasks di Penjelajah Log dengan menelusuri cloudtasks di kolom penelusuran.

Untuk informasi selengkapnya tentang cara membuat kueri dan menganalisis log, lihat Ringkasan kueri dan tampilan log.

Mengirim metrik ke Cloud Monitoring

Cloud Tasks mengirim data metrik dari resource yang dipantau ke Google Cloud Observability. Resource yang dipantau di Monitoring mewakili entitas logis atau fisik, seperti virtual machine, database, atau aplikasi. Resource yang dipantau berisi kumpulan metrik unik yang dapat dijelajahi, dilaporkan melalui dasbor, atau digunakan untuk membuat pemberitahuan.

Cloud Tasks mengirim data metrik dari resource yang dipantau berikut ke Google Cloud Observability:

Setiap resource juga memiliki kumpulan label resource, yang merupakan pasangan nilai kunci yang menyimpan informasi tambahan tentang resource. Label resource tersedia untuk semua metrik yang terkait dengan resource dan dijelaskan dalam tabel berikut.

Metrik dan label resource

String "jenis metrik" dalam tabel ini harus diawali dengan cloudtasks.googleapis.com/. Awalan tersebut telah dihilangkan dari entri dalam tabel. Saat membuat kueri label, gunakan awalan metric.labels.; misalnya, metric.labels.LABEL="VALUE".

Jenis metrik Tahap peluncuran (Tingkat hierarki resource)
Nama tampilan
Jenis, Tipe, Unit
Resource yang dimonitor		 Deskripsi
Label
api/request_count GA  (project)
Permintaan API
DELTA, INT64, 1
cloud_tasks_queue 		Jumlah panggilan Cloud Tasks API. Dibuat sampelnya setiap 60 detik. Setelah sampelnya dibuat, data tidak akan terlihat selama maksimal 240 detik.
api_method: Metode API yang dipanggil (misalnya, CreateTask).
response_code: Kode respons kanonis sebagai string (misalnya, 'ok').
queue/depth GA  (project)
Kedalaman antrean
GAUGE, INT64, 1
cloud_tasks_queue 		Jumlah tugas dalam antrean. Dibuat sampelnya setiap 60 detik. Setelah sampelnya dibuat, data tidak akan terlihat selama maksimal 120 detik.
queue/task_attempt_count GA  (project)
Jumlah percobaan tugas
DELTA, INT64, 1
cloud_tasks_queue 		Jumlah upaya tugas yang dikelompokkan menurut kode respons. Dibuat sampelnya setiap 60 detik. Setelah sampelnya dibuat, data tidak akan terlihat selama maksimal 180 detik.
response_code: Kode respons kanonis sebagai string (misalnya, 'ok').
queue/task_attempt_delays GA  (project)
Penundaan upaya tugas
DELTA, DISTRIBUTION, ms
cloud_tasks_queue 		Penundaan antara setiap waktu percobaan terjadwal dan waktu percobaan sebenarnya. Dibuat sampelnya setiap 60 detik. Setelah sampelnya dibuat, data tidak akan terlihat selama maksimal 120 detik.

Tabel dihasilkan pada 24-01-2025 16.56.52 UTC.

Untuk melihat semua jenis resource, lihat Jenis resource yang dimonitor. Untuk melihat semua jenis metrik, lihat metrikGoogle Cloud

Membaca data metrik

Anda dapat membaca data metrik, yang juga disebut data deret waktu, menggunakan metode timeSeries.list di Cloud Monitoring API. Ada beberapa cara untuk memanggil metode, termasuk menggunakan library klien khusus bahasa, atau dengan membuat diagram dengan Metrics Explorer. Untuk pengantar metrik dan deret waktu, lihat Metrik, deret waktu, dan resource. Untuk mempelajari cara membaca data metrik, lihat Mengambil data deret waktu.

Menggunakan dasbor dan pemberitahuan Monitoring

Anda dapat menggunakan dasbor Monitoring dan diagram terkaitnya untuk memvisualisasikan data metrik Cloud Tasks.

Untuk memantau metrik ini di Monitoring, Anda dapat membuat dasbor kustom. Anda juga dapat menambahkan pemberitahuan berdasarkan metrik ini.