Dokumen ini menjelaskan cara membaca data metrik, yang juga disebut data deret waktu, dengan menggunakan metode timeSeries.list
di Monitoring API.
Dokumen ini menjelaskan cara menggunakan library klien untuk memanggil metode
timeSeries.list
.
Ringkasan
Setiap panggilan ke metode timeSeries.list
dapat menampilkan
sejumlah deret waktu dari satu jenis metrik. Misalnya, jika Anda menggunakan Compute Engine, jenis metrik compute.googleapis.com/instance/cpu/usage_time
memiliki deret waktu terpisah untuk setiap instance VM Anda.
Untuk pengantar metrik dan deret waktu, lihat Metrik, deret waktu, dan resource.
Anda menentukan data deret waktu yang diinginkan dengan memberikan informasi berikut ke metode timeSeries.list
:
- Ekspresi filter yang menentukan jenis metrik. Secara opsional, filter memilih subset deret waktu metrik dengan menentukan resource yang menghasilkan deret waktu atau menentukan nilai untuk label tertentu dalam deret waktu.
- Interval waktu yang membatasi jumlah data yang ditampilkan.
- Secara opsional, spesifikasi cara menggabungkan beberapa deret waktu untuk menghasilkan ringkasan gabungan data. Untuk mengetahui informasi dan contoh selengkapnya, lihat Menggabungkan data.
Filter deret waktu
Anda menentukan deret waktu yang akan diambil dengan meneruskan
filter deret waktu ke metode
timeSeries.list
.
Berikut adalah daftar komponen filter umum:
Filter harus menentukan satu jenis metrik. Contoh:
metric.type = "compute.googleapis.com/instance/cpu/usage_time"
Untuk mengambil metrik yang ditentukan pengguna, ubah awalan metric.type di filter menjadi
custom.googleapis.com
atau awalan lain jika digunakan;external.googleapis.com
sering digunakan.Filter dapat menentukan nilai untuk label dimensi metrik. Jenis metrik menentukan label yang ada. Contoh:
(metric.label.instance_name = "your-instance-id" OR metric.label.instance_name = "your-other-instance-id")
Dalam ekspresi sebelumnya,
label
sudah benar meskipun objek metrik sebenarnya menggunakanlabels
sebagai kuncinya.Filter hanya dapat memilih deret waktu yang berisi jenis resource yang dipantau tertentu:
resource.type = "gce_instance"
Komponen filter dapat digabungkan menjadi satu filter deret waktu, seperti berikut:
metric.type = "compute.googleapis.com/instance/cpu/usage_time" AND
(metric.label.instance_name = "your-instance-id" OR
metric.label.instance_name = "your-other-instance-id")
Jika Anda tidak menentukan nilai untuk semua label metrik, metode list
akan menampilkan deret waktu untuk setiap kombinasi nilai dalam label yang tidak ditentukan. Metode ini hanya menampilkan deret waktu yang memiliki data.
Interval waktu
Saat menggunakan API untuk membaca data, Anda menentukan interval waktu
yang datanya ingin Anda ambil dengan menyetel waktu mulai dan berakhir.
API mengambil data dari interval (start, end]
, yaitu,
dari setelah waktu mulai hingga waktu berakhir.
Waktu mulai tidak boleh setelah waktu berakhir. Jika Anda menentukan waktu mulai yang lebih lambat daripada waktu berakhir, API akan menampilkan error.
Jika Anda hanya ingin mengambil data dengan stempel waktu tertentu, tetapkan waktu mulai sama dengan waktu berakhir, atau dengan kata lain, jangan tetapkan waktu mulai.
Format waktu
Waktu mulai dan berakhir harus ditentukan sebagai string dalam format RFC 3339. Contoh:
2024-03-01T12:34:56+04:00 2024-03-01T12:34:56.992Z
Perintah date -Iseconds
di Linux berguna untuk membuat stempel waktu.
Operasi daftar dasar
Metode timeSeries.list
dapat digunakan untuk menampilkan data mentah sederhana, atau dapat digunakan untuk menampilkan data yang telah diproses secara intensif. Bagian ini menggambarkan cara mencantumkan deret waktu yang tersedia dan cara mendapatkan nilai dalam deret waktu tertentu.
Contoh: Mencantumkan deret waktu yang tersedia
Contoh ini menunjukkan cara mencantumkan hanya nama dan deskripsi deret waktu yang cocok dengan filter, bukan menampilkan semua data yang tersedia:
C#
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Go
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Java
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Node.js
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
PHP
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Python
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Ruby
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Jika Anda mengalami kesulitan, lihat Memecahkan masalah Monitoring API.
Contoh: Mendapatkan data deret waktu
Contoh ini menampilkan pengukuran pemakaian CPU yang direkam selama interval 20 menit untuk instance Compute Engine tertentu. Jumlah data yang ditampilkan bergantung pada rasio pengambilan sampel metrik. Karena pemakaian CPU diambil sampelnya setiap menit, hasil kueri ini adalah sekitar 20 titik data. Jika beberapa titik data ditampilkan untuk deret waktu, API akan menampilkan titik data di setiap deret waktu dalam urutan waktu terbalik; tidak ada penggantian untuk pengurutan titik ini.
C#
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Go
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Java
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Node.js
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
PHP
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Python
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Ruby
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Jika Anda mengalami kesulitan, lihat Memecahkan masalah Monitoring API.
Menggabungkan data
Metode timeSeries.list
dapat melakukan agregasi dan pengurangan statistik pada data deret waktu yang ditampilkan. Bagian berikut menunjukkan dua contoh.
Untuk mempelajari lebih lanjut, lihat
Pemfilteran dan agregasi: memanipulasi deret waktu.
Contoh: Menyelaraskan deret waktu
Contoh ini mengurangi 20 pengukuran pemakaian individual dalam setiap deret waktu menjadi 2 pengukuran: pemakaian rata-rata untuk dua periode 10 menit dalam interval 20 menit. Data dari setiap deret waktu pertama-tama diselaraskan ke dalam periode 10 menit, lalu nilai dalam setiap periode 10 menit dirata-ratakan.
Operasi perataan memiliki dua keunggulan: meratakan data, dan meratakan data dari semua data deret waktu pada batas 10 menit yang tepat. Data yang diselaraskan kemudian dapat diproses lebih lanjut.
C#
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Go
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Java
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Node.js
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
PHP
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Python
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Ruby
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Jika Anda mengalami kesulitan, lihat Memecahkan masalah Monitoring API.
Contoh: Mengurangi di seluruh deret waktu
Contoh ini memperluas contoh sebelumnya dengan menggabungkan deret waktu yang selaras dari tiga instance VM menjadi satu deret waktu yang mengukur penggunaan rata-rata semua instance.
C#
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Go
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Java
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Node.js
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
PHP
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Python
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Ruby
Untuk melakukan autentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN
ke apis-s3ns.fr
.
Jika Anda mengalami kesulitan, lihat Memecahkan masalah Monitoring API.
Langkah berikutnya
- Pelajari Retensi dan latensi data metrik.
- Pelajari Pemfilteran dan agregasi: memanipulasi deret waktu.