Sekali per bulan, Looker (Google Cloud core) menjadwalkan periode pemeliharaan selama instance Anda akan diupgrade. Selama periode pemeliharaan, instance Anda akan dimulai ulang dan Anda tidak akan dapat mengakses instance Anda untuk sementara. Anda dapat menentukan masa pemeliharaan untuk instance Anda dalam bentuk hari dalam seminggu dan waktu dalam sehari saat pemeliharaan akan berlangsung. Jika Anda tidak menentukan masa pemeliharaan pilihan, upgrade akan berlangsung dalam waktu dua minggu setelah peluncuran versi Looker (Google Cloud core) baru. Anda juga dapat menentukan Periode Penolakan Pemeliharaan untuk memblokir pemeliharaan agar tidak berlangsung selama waktu yang Anda tentukan.
Jika Anda menentukan Periode Penolakan Pemeliharaan selama instance Looker (Google Cloud core) diupgrade ke versi Looker berikutnya yang didukung, fitur yang tersedia di instance Looker (Google Cloud core) Anda mungkin berbeda dengan setelan yang dinyatakan Google Cloud konsol tersedia dalam rilis yang diupgrade.
Halaman dokumentasi ini membahas cara menemukan informasi tentang pemeliharaan terjadwal, menetapkan periode pilihan untuk pemeliharaan, menentukan periode penolakan pemeliharaan, dan mengonfigurasi notifikasi tentang update pemeliharaan mendatang untuk instance Looker (Google Cloud core).
Saluran rilis dan kebijakan pemeliharaan
Jika instance Looker (Google Cloud core) terdaftar dalam saluran rilis, setelan pemeliharaan yang dapat Anda konfigurasi bergantung pada saluran rilis instance Anda:
- Saluran cepat: Masa pemeliharaan dan periode penolakan pemeliharaan tidak didukung. Jika Anda mendaftar ke saluran Cepat, masa pemeliharaan atau periode penolakan pemeliharaan yang sebelumnya ditetapkan untuk instance akan dihapus.
- Saluran reguler: Anda dapat menentukan masa pemeliharaan pilihan dan periode penolakan pemeliharaan.
- Tanpa saluran: Anda dapat menentukan masa pemeliharaan pilihan dan periode penolakan pemeliharaan.
Peran yang diperlukan
Guna mendapatkan izin yang diperlukan untuk mengonfigurasi setelan pemeliharaan untuk instance Looker (Google Cloud core), minta administrator untuk memberi Anda peran IAM Looker Admin (roles/looker.admin) di project tempat instance dibuat.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Setelan pemeliharaan
Looker (Google Cloud core) memungkinkan Anda mengonfigurasi update pemeliharaan melalui serangkaian setelan pemeliharaan.
Anda dapat mengonfigurasi pemeliharaan agar dijadwalkan pada waktu saat periode nonaktif singkat menyebabkan dampak terendah pada instance Anda. Anda dapat mengonfigurasi hal berikut:
Masa Pemeliharaan: Hari dalam seminggu dan jam saat Looker (Google Cloud core) menjadwalkan pemeliharaan. Masa pemeliharaan berlangsung selama satu jam.
Periode Penolakan Pemeliharaan: Blok hari saat Looker (Google Cloud core) tidak menjadwalkan pemeliharaan. Periode penolakan pemeliharaan dapat berlangsung hingga 60 hari. Anda harus memberikan waktu minimal 14 hari dari waktu pemeliharaan antara 2 periode penolakan pemeliharaan.
Anda dapat memperbarui kebijakan pemeliharaan saat membuat instance Looker (Google Cloud core) atau dengan mengedit konfigurasi untuk instance yang ada.
Menetapkan periode pilihan untuk pemeliharaan
Untuk menentukan periode pilihan saat Looker (Google Cloud core) akan menjadwalkan pemeliharaan, pilih salah satu opsi berikut:
console
Di Google Cloud konsol, buat instance Looker (Google Cloud core) atau edit konfigurasi untuk instance Looker (Google Cloud core) yang ada.
Di bagian Masa Pemeliharaan, di bagian Pemeliharaan Pilihan, konfigurasi setelan berikut untuk masa pemeliharaan:
Hari: Hari dalam seminggu saat instance Anda akan diupdate
Periode waktu: Perkiraan waktu dalam sehari saat pemeliharaan instance akan dimulai
Klik Simpan.
Jika Anda telah mendaftarkan instance Anda ke saluran rilis Cepat, opsi ini tidak akan tersedia di Google Cloud konsol.
gcloud
Gunakan perintah gcloud looker instances create jika Anda membuat instance, atau gunakan perintah gcloud looker instances update jika Anda memperbarui instance, dan sertakan parameter berikut:
--maintenance-window-day=MAINTENANCE_WINDOW_DAY --maintenance-window-time=MAINTENANCE_WINDOW_TIME
Ganti kode berikut:
MAINTENANCE_WINDOW_DAY: hari dalam seminggu saat instance Anda akan diupdate. Harus berupa salah satu dari hal berikut:friday,monday,saturday,sunday,thursday,tuesday,wednesday.MAINTENANCE_WINDOW_TIME: waktu mulai masa pemeliharaan dalam format 24 jam UTC (misalnya,13:00,17:45).
Jika Anda telah mendaftarkan instance Looker (Google Cloud core) ke saluran Cepat dari fitur pratinjau saluran rilis, Anda tidak akan dapat menetapkan masa pemeliharaan untuk instance tersebut.
Setelah Anda menentukan masa pemeliharaan, perubahan pada setelan Anda akan memerlukan waktu hingga satu minggu untuk diterapkan.
Mengonfigurasi periode penolakan pemeliharaan
Jika ingin menunda pemeliharaan terjadwal ke waktu yang lebih lama, Anda dapat mengubah periode penolakan pemeliharaan instance. Periode penolakan pemeliharaan dapat berlangsung hingga 60 hari.
Anda harus memberikan waktu minimal 14 hari dari waktu pemeliharaan antara 2 periode penolakan pemeliharaan.
Untuk menentukan periode pilihan saat Looker (Google Cloud core) tidak akan melakukan pemeliharaan, pilih salah satu opsi berikut:
console
Di Google Cloud konsol, buat instance Looker (Google Cloud core), atau edit konfigurasi untuk instance Looker (Google Cloud core) yang ada.
Di bagian Periode Penolakan Pemeliharaan, konfigurasi setelan berikut untuk periode penolakan pemeliharaan:
Tanggal mulai: Pilih tanggal mulai periode saat pemeliharaan tidak akan terjadi.
Tanggal akhir: Pilih tanggal akhir periode saat pemeliharaan tidak akan terjadi.
Waktu mulai/akhir: Tentukan waktu spesifik saat Periode Penolakan Pemeliharaan dimulai (pada tanggal yang Anda tentukan untuk Tanggal mulai) dan berakhir (pada tanggal yang Anda tentukan untuk Tanggal akhir).
- Klik Simpan.
Jika Anda telah mendaftarkan instance Anda ke saluran rilis Cepat, opsi ini tidak akan tersedia di Google Cloud konsol.
gcloud
Gunakan perintah gcloud looker instances create jika Anda membuat instance, atau gunakan perintah gcloud looker instances update jika Anda memperbarui instance, dan sertakan parameter berikut:
--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE
--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE
--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME
Ganti kode berikut:
DENY_MAINTENANCE_PERIOD_START_DATE: tanggal mulai periode penolakan dalam formatYYYY-MM-DD.DENY_MAINTENANCE_PERIOD_END_DATE: tanggal akhir periode penolakan dalam formatYYYY-MM-DD.DENY_MAINTENANCE_PERIOD_TIME: waktu mulai dan akhir dalam format 24 jam UTC (misalnya,13:00,17:45).
Jika Anda telah mendaftarkan instance Looker (Google Cloud core) ke saluran Cepat dari fitur pratinjau saluran rilis, Anda tidak akan dapat menetapkan periode penolakan pemeliharaan untuk instance tersebut.
Contoh pemeliharaan
Sebagai contoh, Anda dapat menetapkan setelan pemeliharaan instance produksi Anda sebagai berikut:
- Masa Pemeliharaan: Hari Minggu antara pukul 12.00-01.00 ET
- Periode Penolakan Pemeliharaan: 1 Desember pukul 22.00 hingga 15 Januari pukul 22.00
Notifikasi pemeliharaan mendatang
Anda dapat menerima notifikasi tentang pemeliharaan mendatang yang dikirimkan ke email Anda hingga satu minggu sebelum jadwal pemeliharaan. Jika Anda ingin menyetel filter email untuk notifikasi, judul emailnya adalah [Looker (Google Cloud core) Advanced Maintenance Notification] Your instance is scheduled for maintenance.
Notifikasi pemeliharaan tidak dikirim secara default. Jika Anda ingin menerima notifikasi tentang update pemeliharaan mendatang, Anda harus menyelesaikan kedua langkah berikut:
- Tetapkan masa pemeliharaan.
- Aktifkan notifikasi pemeliharaan di tingkat project, atau siapkan pemberitahuan berbasis log.
- Untuk menerima notifikasi tentang pemeliharaan terjadwal, Anda harus menyelesaikan kedua langkah tersebut setidaknya tujuh hari sebelum update pemeliharaan terjadwal berikutnya untuk instance Looker (Google Cloud core) Anda.
Notifikasi yang dikonfigurasi melalui Google Cloud konsol dikirim ke alamat email yang terkait dengan Akun Google Anda. Anda dapat menggunakan alias email kustom (seperti alias email tim).
Jika instance Looker (Google Cloud core) Anda menggunakan SAML atau OpenID Connect (OIDC) untuk autentikasi, atau jika Anda ingin merutekan notifikasi ke saluran komunikasi pihak ketiga seperti Slack, PagerDuty, atau webhook kustom, Anda dapat menyiapkan pemberitahuan berbasis log.
Anda dapat memilih untuk menerima notifikasi pemeliharaan untuk semua instance Looker (Google Cloud core) yang memiliki masa pemeliharaan di project tertentu. Anda akan menerima satu notifikasi per instance.
Mengaktifkan notifikasi pemeliharaan
Untuk mengaktifkan notifikasi pemeliharaan di Google Cloud konsol, ikuti langkah-langkah berikut:
Buka halaman Komunikasi di Google Cloud konsol:
Pilih tab Notifikasi Produk.
Pilih project Anda dari menu drop-down.
Di baris untuk Looker (Google Cloud core), tetapkan tombol email ke AKTIF.
Menyiapkan pemberitahuan berbasis log untuk peristiwa pemeliharaan
Jika Anda melakukan autentikasi ke Google Cloud menggunakan Workforce Identity Federation, Google Cloud konsol tidak dapat mengirim notifikasi pemeliharaan ke akun gabungan Anda. Selain itu, Anda mungkin ingin merutekan notifikasi ke layanan seperti Slack, PagerDuty, atau webhook kustom. Untuk menerima notifikasi dalam skenario ini, Anda dapat mengonfigurasi kebijakan pemberitahuan berbasis log di Cloud Logging.
Saat Looker (Google Cloud core) menjadwalkan, memulai, menyelesaikan, atau membatalkan update pemeliharaan, Looker (Google Cloud core) akan menulis entri log aktivitas ke Logging. Anda dapat membuat kebijakan pemberitahuan yang cocok dengan entri log ini dan mengirim notifikasi ke saluran notifikasiyang dikonfigurasi.
Untuk membuat pemberitahuan berbasis log untuk peristiwa pemeliharaan, ikuti petunjuk dalam dokumentasi Membuat kebijakan pemberitahuan berbasis log menggunakan Logs Explorer untuk membuat kebijakan pemberitahuan. Untuk contoh kueri yang akan digunakan dalam kebijakan, lihat Kueri log pemeliharaan.
Kueri log pemeliharaan
Gunakan kueri berikut untuk membuat pemberitahuan berbasis log untuk berbagai tahap siklus proses pemeliharaan.
Ganti LOOKER_INSTANCE_NAME dengan nama instance Looker (Google Cloud core) Anda.
Notifikasi lanjutan (terjadwal): Memberi tahu Anda saat pemeliharaan dijadwalkan untuk instance Anda.
log_id("maintenance.googleapis.com/activity_log") AND resource.type = "gce_instance" AND labels.activity_type_name = "LookerRolloutAdvanced" AND labels.instance_id = "LOOKER_INSTANCE_NAME"Notifikasi dimulai: Memberi tahu Anda saat pemeliharaan dimulai di instance Anda.
log_id("maintenance.googleapis.com/activity_log") AND resource.type = "gce_instance" AND labels.activity_type_name = "LookerRolloutInProgress" AND labels.is_completed = "false" AND labels.is_failed = "false" AND labels.instance_id = "LOOKER_INSTANCE_NAME"Notifikasi selesai (berhasil): Memberi tahu Anda saat pemeliharaan selesai dengan sukses.
log_id("maintenance.googleapis.com/activity_log") AND resource.type = "gce_instance" AND labels.activity_type_name = "LookerRolloutInProgress" AND labels.is_completed = "true" AND labels.is_failed = "false" AND labels.instance_id = "LOOKER_INSTANCE_NAME"Notifikasi gagal atau dibatalkan: Memberi tahu Anda jika pemeliharaan gagal atau dibatalkan.
log_id("maintenance.googleapis.com/activity_log") AND resource.type = "gce_instance" AND (labels.is_failed = "true" OR labels.activity_type_name = "LookerRolloutCanceled") AND labels.instance_id = "LOOKER_INSTANCE_NAME"
Menemukan pemeliharaan terjadwal
Jika pemeliharaan telah dijadwalkan untuk instance Anda, Anda dapat melihatnya dengan mengikuti langkah-langkah berikut:
Buka halaman Looker (Google Cloud core) di Google Cloud konsol.
Pilih nama instance yang pemeliharaan terjadwalnya ingin Anda lihat.
Saat Anda melihat detail konfigurasi untuk instance Anda, di halaman Detail, Anda dapat melihat informasi berikut: