Kemampuan observasi di Cloud Tasks

Google Cloud Observability memungkinkan Anda memantau dan menganalisis aktivitas Cloud Tasks, pertumbuhan antrean, dan perilaku eksekusi. Anda dapat mengevaluasi kondisi aplikasi, mendiagnosis kegagalan tugas, dan memecahkan masalah performa menggunakan metrik dan log yang dikumpulkan.

Secara default, Cloud Tasks mengirim metrik sistem dan resource ke Cloud Monitoring dan mengekspor log audit Aktivitas Admin ke Cloud Logging. Log audit Akses Data dinonaktifkan secara default dan memerlukan konfigurasi eksplisit.

Mengirim log audit ke Cloud Logging

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

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

Untuk mengetahui informasi selengkapnya, lihat Logging audit Cloud Tasks.

Menggunakan Cloud Logging dengan antrean

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

  • Operasi tugas:
    • CreateTask
    • DeleteTask
  • Operasi percobaan:
    • 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 > Queues.

    Buka Antrean

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

  3. Di halaman Queue details, klik tab Logs.

  4. Klik Aktifkan log, lalu klik Aktifkan 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 mencatat fraksi operasi tersebut. Untuk mencatat semua operasi, tetapkan ke 1.0. Untuk tidak mencatat operasi, tetapkan ke 0.0 (ini adalah defaultnya).

Menonaktifkan logging

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

Konsol

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

    Buka Antrean

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

  3. Di halaman Queue details, klik tab Logs.

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

    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 Anda. Untuk mempelajari cara melihat log di Logs Explorer, ikuti petunjuk di Melihat log menggunakan Logs Explorer.
  • Analytics Kemampuan Observasi dirancang untuk menjalankan kueri guna menganalisis log Anda, lalu melihat atau membuat diagram hasilnya. Untuk mempelajari cara menggunakan Observability Analytics, ikuti petunjuk di Mengueri dan menganalisis log dengan Observability Analytics.

Anda dapat memfilter log Cloud Tasks di Logs Explorer dengan menelusuri cloudtasks di kolom penelusuran.

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

Mengirim metrik ke Monitoring

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

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

Setiap resource juga memiliki serangkaian label resource, yang merupakan key-value pair 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 percobaan 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 2026-09-25 02:24:56 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 menggunakan Metrics Explorer. Untuk pengantar tentang 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 terkait 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.