Dokumen ini menjelaskan cara mengelola cek uptime Anda menggunakan konsol Google Cloud, Google Cloud CLI, Cloud Monitoring API, dan library klien.
Mencantumkan semua cek uptime
Konsol
-
Di panel navigasi konsol Google Cloud, pilih Monitoring, lalu pilih Uptime checks:
Contoh berikut menampilkan contoh halaman Uptime checks:
(Opsional) Untuk membatasi cek uptime yang tercantum, tambahkan filter.
Setiap filter terdiri dari nama dan nilai. Anda dapat menetapkan nilai menjadi pencocokan persis untuk nama cek uptime, atau kecocokan sebagian. Kecocokan tidak peka huruf besar/kecil. Misalnya, untuk mencantumkan semua cek uptime yang namanya berisi
default
, lakukan hal berikut:- Klik Filter tabel, lalu pilih Nama tampilan.
- Masukkan
default
, lalu tekan tombol kembali.
Jika Anda memiliki beberapa filter, filter akan otomatis digabungkan oleh
AND
yang logis, kecuali jika Anda menyisipkan filterOR
. Contoh sebelumnya menggunakan filterOR
sehingga cek uptime akan dicantumkan jika namanya cocok dengandefault
atauTesting check
.
gcloud
Untuk mencantumkan cek uptime dan monitor sintetis, jalankan perintah gcloud monitoring uptime list-configs
:
gcloud monitoring uptime list-configs
Data yang ditampilkan mencakup hal berikut:
- Nama dan nama tampilan.
- Periksa ID.
- Resource yang dipantau.
- Periode di antara pemeriksaan.
Anda dapat mengonfigurasi perintah Google Cloud CLI untuk memfilter dan mengurutkan hasil.
API
Untuk mencantumkan cek uptime dan monitor sintetis, panggil metode projects.uptimeCheckConfigs.list
. Tentukan parameter berikut:
parent: Project yang cek uptime-nya ingin Anda cantumkan. Formatnya adalah:
projects/PROJECT_ID
Untuk mendapatkan cek uptime tertentu, panggil metode projects.uptimeCheckConfigs.get
. Tentukan parameter berikut:
name: Nama lengkap konfigurasi cek uptime.
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
Untuk mengetahui informasi selengkapnya tentang ID cek uptime, lihat Menemukan ID unik cek uptime.
C#
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Go
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
PHP
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Ruby
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Melihat detail cek uptime
Konsol
-
Di panel navigasi konsol Google Cloud, pilih Monitoring, lalu pilih Uptime checks:
Cari cek uptime yang ingin Anda lihat, lalu klik namanya.
Screenshot berikut menunjukkan detail waktu beroperasi untuk cek uptime dengan nama "My Uptime Check":
Halaman Detail waktu beroperasi berisi informasi berikut:
- Interval waktu yang dipilih. Secara default, intervalnya adalah 1 jam.
- Nama cek uptime. Dalam contoh, namanya adalah My Uptime Check.
- Label yang Anda tambahkan ke cek uptime.
Persentase waktu beroperasi dan latensi rata-rata. Nilai Persen waktu beroperasi adalah persentase yang dihitung sebagai
(S/T)*100
, denganS
adalah jumlah respons pemeriksaan yang berhasil danT
adalah jumlah total respons cek, dari semua lokasi. Untuk pemeriksaan grup, nilaiS
danT
dijumlahkan dari semua anggota grup saat ini.Misalnya, selama periode 25 menit, cek uptime dengan periode satu menit yang berjalan dari semua region akan mendapatkan 25 permintaan dari masing-masing 6 lokasi, dengan total 150 permintaan. Jika dasbor melaporkan waktu beroperasi 83,3%, berarti 125 dari 150 permintaan berhasil.
Panel Lulus pemeriksaan dan Latensi pemeriksaan waktu beroperasi secara grafis menampilkan jumlah pemeriksaan yang lulus dan latensi dari setiap pemeriksaan sebagai fungsi waktu.
Panel Current status menampilkan status pemeriksaan terbaru. Lingkaran hijau dengan tanda centang di samping region menunjukkan bahwa pemeriksaan terakhir telah berhasil dijalankan di region tersebut; lingkaran merah dengan x menunjukkan kegagalan.
Panel Configuration menampilkan konfigurasi cek uptime. Data ini ditetapkan saat cek uptime dibuat. Nilai Check Id sesuai dengan nilai
CHECK_ID
dalam panggilan API.Panel Alert Policy mencantumkan informasi tentang kebijakan pemberitahuan terkait. Di dasbor contoh, satu kebijakan pemberitahuan dikonfigurasi.
gcloud
Untuk mencantumkan detail cek uptime atau monitor sintetis, jalankan perintah gcloud monitoring uptime describe
:
gcloud monitoring uptime describe CHECK_ID
Sebelum menjalankan perintah sebelumnya, ganti CHECK_ID dengan ID cek uptime atau monitor sintetis. Anda dapat menemukan ID dengan menjalankan perintah gcloud monitoring uptime list-configs
dan memeriksa kolom name. Untuk mengetahui informasi selengkapnya, lihat
Menemukan ID unik cek uptime.
Data yang ditampilkan untuk cek uptime mencakup hal berikut:
- Nama dan nama tampilan.
- Periksa ID.
- Resource yang dipantau.
- Periode di antara pemeriksaan.
API
Untuk mencantumkan detail cek uptime atau monitor sintetis, panggil metode projects.uptimeCheckConfigs.get
. Tentukan parameter berikut:
name: Nama lengkap konfigurasi cek uptime.
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
Untuk mengetahui informasi selengkapnya tentang ID cek uptime, lihat Menemukan ID unik cek uptime.
C#
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Go
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
PHP
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Ruby
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Mengedit cek uptime
Anda dapat mengubah beberapa kolom cek uptime. Misalnya, Anda mungkin ingin pemeriksaan lebih sering terjadi, atau Anda mungkin ingin meningkatkan waktu tunggu yang terkait dengan validasi respons. Namun, jika cek uptime Anda tidak dikonfigurasi dengan protokol, jenis resource, atau resource yang benar, hapus cek uptime saat ini dan buat yang baru.
Untuk mengetahui informasi tentang cara mengedit kebijakan pemberitahuan yang memantau cek uptime, lihat dokumen berikut:
- Mengelola kebijakan menggunakan Konsol Google Cloud.
- Mengelola kebijakan pemberitahuan melalui API .
Untuk mengedit cek uptime publik, Anda dapat menggunakan proses di salah satu tab berikut. Untuk mengedit cek uptime pribadi, gunakan tab Console atau API:
Konsol
-
Di panel navigasi konsol Google Cloud, pilih Monitoring, lalu pilih Uptime checks:
Temukan cek uptime yang ingin Anda edit, lalu lakukan salah satu hal berikut:
- Klik More more_vert dan pilih Edit.
- Lihat detail cek uptime, lalu klik Edit.
Ubah nilai kolom sesuai kebutuhan. Anda tidak dapat mengubah semua kolom. Jika nilai header kustom suatu pemeriksaan disembunyikan, Anda tidak dapat membuatnya terlihat.
Untuk memverifikasi apakah pemeriksaan berfungsi, klik Test. Jika pengujian gagal, lihat Pemeriksaan gagal untuk mengetahui kemungkinan penyebabnya.
Klik Save.
gcloud
Untuk mengubah cek uptime atau monitor sintetis, jalankan perintah gcloud monitoring uptime update
:
gcloud monitoring uptime update CHECK_ID OPTIONAL_FLAGS
Sebelum Anda menjalankan perintah sebelumnya, lakukan hal berikut:
Ganti CHECK_ID dengan ID cek uptime atau monitor sintetis. Anda dapat menemukan ID dengan menjalankan perintah
gcloud monitoring uptime list-configs
dan memeriksa kolom name. Untuk mengetahui informasi selengkapnya, lihat Menemukan ID unik cek uptime.Tentukan kolom yang ingin Anda ubah.
Misalnya, untuk menetapkan periode cek uptime 10 menit, jalankan perintah berikut:
gcloud monitoring uptime update CHECK_ID --period=10
API
Panggil metode projects.uptimeCheckConfigs.patch
. Setel parameter ke metode sebagai berikut:
uptimeCheckConfig.name: Wajib diisi. Ini adalah bagian dari REST URL. Ini adalah nama resource cek uptime yang akan diedit:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
Untuk mengetahui informasi selengkapnya tentang ID cek uptime, lihat Menemukan ID unik cek uptime.
updateMask: Opsional. Ini adalah parameter kueri:
?updateMask=[FIELD_LIST]
.[FIELD_LIST]
adalah daftar kolom yang dipisahkan koma dalam objekUptimeCheckConfig
yang harus diubah. Contoh:"resource.type,httpCheck.path"
Isi permintaan harus berisi
UptimeCheckConfig
dengan nilai kolom baru.
Jika updateMask
ditetapkan, hanya kolom yang tercantum dalam updateMask
yang akan menggantikan kolom terkait dalam konfigurasi yang ada. Jika suatu kolom memiliki subkolom, dan kolom tercantum dalam mask kolom, tetapi tidak satu pun subkolomnya, semua subkolom dari kolom tersebut akan menggantikan kolom yang sesuai.
Jika updateMask
tidak ditetapkan, konfigurasi dalam isi permintaan
akan menggantikan seluruh konfigurasi yang ada.
Metode patch
menampilkan objek UptimeCheckConfig
untuk konfigurasi yang diubah.
C#
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Go
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
PHP
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Ruby
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Mungkin ada penundaan hingga 5 menit sebelum Anda melihat hasil cek uptime yang baru. Selama waktu tersebut, hasil cek uptime sebelumnya ditampilkan di dasbor dan digunakan dalam kebijakan pemberitahuan.
Menghapus cek uptime
Sebaiknya hapus cek uptime saat Anda menonaktifkan layanan atau resource yang dipantau. Catatan: Sebelum Anda menghapus cek uptime, pastikan tidak ada kebijakan pemberitahuan yang memantau cek uptime. Saat kebijakan pemberitahuan memantau cek uptime, Google Cloud Console akan mencegah penghapusan cek uptime tersebut. Namun, Cloud Monitoring API tidak menghasilkan error atau mencegah penghapusan. Tidak ada insiden yang dibuat untuk pemeriksaan yang hilang.
Untuk menghapus cek uptime, lakukan hal berikut:
Konsol
-
Di panel navigasi konsol Google Cloud, pilih Monitoring, lalu pilih Uptime checks:
Temukan cek uptime yang ingin Anda edit, lalu lakukan salah satu hal berikut:
- Klik Lainnya more_vert dan pilih Hapus.
- Lihat detail cek uptime, lalu klik Delete
gcloud
Untuk menghapus cek uptime atau monitor sintetis, jalankan perintah gcloud monitoring uptime delete
:
gcloud monitoring uptime delete CHECK_ID
Sebelum menjalankan perintah sebelumnya, ganti CHECK_ID dengan ID cek uptime atau monitor sintetis. Anda dapat menemukan ID dengan menjalankan perintah gcloud monitoring uptime list-configs
dan memeriksa kolom name. Untuk mengetahui informasi selengkapnya, lihat
Menemukan ID unik cek uptime.
API
Untuk menghapus cek uptime atau monitor sintetis, panggil metode projects.uptimeCheckConfigs.delete
. Isi parameter sebagai berikut:
name: Wajib diisi. Ini adalah nama resource konfigurasi cek uptime yang akan dihapus:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
Untuk mengetahui informasi selengkapnya tentang ID cek uptime, lihat Menemukan ID unik cek uptime.
C#
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Go
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
PHP
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Ruby
Untuk mengautentikasi ke Monitoring, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Memantau cek uptime
Sebaiknya buat kebijakan pemberitahuan yang memberi tahu Anda saat cek uptime Anda gagal. Untuk mengetahui informasi selengkapnya, lihat Membuat kebijakan pemberitahuan untuk cek uptime.
Menemukan ID unik cek uptime
Setelah cek uptime Anda dibuat, Monitoring akan menetapkan ID yang disebut sebagai ID cek uptime. ID ini disematkan dalam nama resource untuk cek uptime:
projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
ID cek uptime disertakan dalam respons metode Cloud Monitoring API yang membuat atau mencantumkan cek uptime. Anda juga dapat menemukan ID cek uptime di panel Configuration di halaman Detail uptime di Google Cloud Console. Untuk mengetahui informasi tentang cara melihat halaman Detail waktu beroperasi, lihat bagian Melihat detail cek uptime dalam dokumen ini.
Langkah selanjutnya
- Mencantumkan alamat IP server cek uptime
- Membuat kebijakan pemberitahuan untuk cek uptime
- Membuat diagram metrik cek uptime