Rekomendasi
Pemberi rekomendasi
Pemberi rekomendasi adalah layanan di Google Cloud yang memberikan rekomendasi pengoptimalan untuk produk dan resource Google Cloud.
Setiap pemberi rekomendasi memungkinkan Anda melihat dan mengelola rekomendasi dan insight-nya menggunakan satu atau beberapa klien berikut:
- Hub Rekomendasi
- Dalam konteks menggunakan antarmuka pengguna (UI) layanan di konsol Google Cloud
- REST API atau Google Cloud CLI
Untuk mengetahui detail tentang pemberi rekomendasi dan klien yang didukung, lihat Pemberi rekomendasi.
Setiap perekomendasikan memiliki ID perekomendasikan unik yang mengidentifikasi layanan. Anda menggunakan ID pemberi rekomendasi saat berinteraksi dengan rekomendasi menggunakan perintah gcloud
Rekomendasi, atau API REST atau RPC.
Untuk mengetahui informasi selengkapnya, lihat Pemberi rekomendasi.
Rekomendasi
Rekomendasi adalah saran yang dibuat mesin untuk mengoptimalkan penggunaan resource Cloud Anda. Laporan ini mencakup langkah-langkah yang diperlukan untuk mengambil tindakan atas
rekomendasi. Pemberi rekomendasi memberikan rekomendasi berdasarkan penggunaan resource Anda, menggunakan machine learning atau heuristik. Rekomendasi menyimpan
rekomendasi menggunakan entity Recommendation
.
Rekomendasi memiliki atribut inti berikut:
- Nama
- Deskripsi
- Subjenis pemberi rekomendasi
- Dampak
- Operasi
- Grup operasi
- Info status
- etag
- Prioritas
- Metadata status
- Waktu refresh terakhir
- Referensi insight
- Konfigurasi
Nama
Nama rekomendasi disimpan di kolom name
entitas
Recommendation
. Ini adalah nama untuk rekomendasi dalam format
berikut:
projects/TARGET_PROJECT_ID/locations/LOCATION/recommenders/RECOMMENDER_ID/recommendations/RECOMMENDATION_ID
dengan:
- TARGET_PROJECT_ID adalah ID project tempat rekomendasi dibuat.
- LOCATION adalah lokasi Google Cloud tempat resource yang terkait dengan rekomendasi berada (misalnya,
global
atauus-central1-a
). - RECOMMENDER_ID adalah ID pemberi rekomendasi
yang sepenuhnya memenuhi syarat (misalnya,
google.compute.instance.MachineTypeRecommender
). - RECOMMENDATION_ID adalah ID unik untuk rekomendasi.
Deskripsi
Deskripsi rekomendasi disimpan di kolom description
dari
entitas Recommendation
. Halaman ini hanya tersedia dalam bahasa Inggris. Ini adalah teks yang dapat dibaca manusia
yang menjelaskan rekomendasi. Di konsol Google Cloud, deskripsi
akan muncul saat Anda mengklik untuk melihat detail rekomendasi tambahan.
Subjenis pemberi rekomendasi
Pemberi rekomendasi mungkin memiliki subjenis untuk jenis rekomendasi tertentu. Misalnya, rekomendasi peran Identity and Access Management memiliki subjenis REPLACE_ROLE
dan REMOVE_ROLE
. Subjenis baru mungkin diperkenalkan ke perekomendasikan yang ada dari waktu ke waktu. Ringkasan ini memberikan daftar semua perekomendasikan yang tersedia. Lihat dokumentasi pemberi rekomendasi untuk mendapatkan informasi selengkapnya tentang subjenis rekomendasi yang tersedia.
Dampak pemberi rekomendasi
Dampak mengukur manfaat yang diproyeksikan dari melakukan tindakan yang direkomendasikan. Setiap rekomendasi dapat memiliki jenis dampak berikut yang mewakili hasil yang dapat terjadi sebagai akibat dari penerapan rekomendasi:
Dampak utama bersifat wajib dan disimpan di kolom
primaryImpact
entitasRecommendation
.Dampak sekunder bersifat opsional dan disimpan di kolom
additionalImpact
.
Ada jenis dampak utama dan sekunder berikut:
COST
: Perkiraan jumlah uang yang diperkirakan akan Anda hemat (atau keluarkan) jika menerapkan rekomendasi tertentu. Lihat kolomcost
di bagian CostProjection untuk mengetahui detailnya.PERFORMANCE
: Estimasi peningkatan atau penurunan performa. Perhatikan bahwa beberapa rekomendasi performa dapat mengakibatkan biaya tambahan (misalnya, jika rekomendasinya adalah meningkatkan alokasi CPU atau memori pada VM yang digunakan secara berlebihan).SECURITY
: Estimasi peningkatan postur keamanan. Lihat kolomdetails
di bagian SecurityProjection untuk mengetahui detailnya.MANAGEABILITY
: Estimasi pengurangan toil manual.SUSTAINABILITY
: Estimasi pengurangan emisi karbon. Lihat kolomcarbon_footprint_kg_co2
di bagian SustainabilityProjection dan Metodologi pelaporan Jejak Karbon untuk mengetahui detailnya.
Operasi
Operation
adalah tindakan individual yang harus dilakukan sebagai salah satu langkah atom dalam rekomendasi yang disarankan. Operasi dapat mewakili perubahan berikut:
- Menambahkan, menghapus, atau mengganti kolom objek JSON di resource Google Cloud.
- Menambahkan, menghapus, atau mengganti kolom array JSON di resource Google Cloud. Elemen array JSON diidentifikasi dengan menentukan filter pada jalur.
- Tambahkan resource Google Cloud baru.
- Menghapus resource Google Cloud.
- Uji operasi untuk menunjukkan status asli resource. Operasi pengujian juga dapat digunakan untuk memverifikasi status resource saat ini sebelum menerapkan rekomendasi.
- Menyalin dan memindahkan resource dan kolom Google Cloud.
Setiap Operation
didasarkan secara longgar pada format JSON Path (RFC
6902) untuk patch. RFC ini
dipilih karena memberikan cara yang lebih konsisten untuk mencerminkan perubahan
resource, termasuk skenario kompleks yang biasa ditemukan di Google Cloud. Misalnya, rekomendasi IAM melibatkan array bertingkat untuk mencerminkan pemindahan binding peran akun utama ke peran lain.
Untuk setiap resource, daftar perubahan (tampilan berbasis perbedaan) dapat dibuat dengan cara berikut:
- Status asli: Operasi pengujian mewakili nilai asli kolom. Ini mewakili sisi kiri tampilan perbedaan.
- Status yang direkomendasikan: Operasi non-pengujian mewakili perubahan yang direkomendasikan per kolom. Ini mewakili sisi kanan tampilan perbedaan.
Grup operasi
Grup operasi adalah kumpulan satu atau beberapa operasi yang harus dilakukan
dalam urutan tertentu saat Anda menerapkan rekomendasi. Rekomendasi dapat memiliki satu atau beberapa grup operasi. Grup operasi disimpan di
kolom operationGroups
dalam entity Recommendation
.
Misalnya, rekomendasi yang menyarankan agar Anda mengubah jenis mesin instance VM untuk grup instance Compute Engine memiliki dua grup operasi: satu grup tempat Anda mengubah jenis mesin dalam template instance, dan grup lainnya tempat Anda menerapkan perubahan ke grup instance tertentu.
Karena kumpulan operasi pertama harus selesai sebelum operasi kedua dapat dimulai, kumpulan operasi ini ditentukan sebagai dua grup instance terpisah dalam rekomendasi.
Grup operasi dapat menyertakan operasi pengujian. Operasi pengujian melakukan pemeriksaan untuk memastikan rekomendasi masih valid. Rekomendasi yang menyarankan untuk mengubah jenis mesin instance VM memiliki operasi pengujian yang memeriksa apakah jenis mesin saat ini sama dengan saat rekomendasi dibuat.
Status
Rekomendasi akan melalui banyak transisi status setelah diusulkan. Rekomendasi dapat memiliki status berikut:
ACTIVE
, yang berarti rekomendasi telah dibuat, tetapi tidak ada tindakan yang dilakukan sebagai respons terhadapnya. Rekomendasi dapat diterapkan dengan mengklaimnya. Rekomendasi aktif dapat diperbarui saat resource berubah.CLAIMED
, yang berarti Anda atau proses lain telah mengklaim rekomendasi dan respons terhadapnya sedang dalam proses. Saat rekomendasi diklaim, Rekomendator tidak memperbaruinya saat resource berubah.SUCCEEDED
, yang berarti Anda atau proses lain telah menerapkan rekomendasi ke resource terkait.FAILED
, yang berarti bahwa upaya untuk menerapkan rekomendasi telah gagal.DISMISSED
, yang berarti Anda atau proses lain telah menutup rekomendasi tanpa menerapkannya ke resource terkait. Status ini mencegah rekomendasi muncul dalam daftar rekomendasi, dan biasanya diterapkan oleh administrator yang telah membatalkan rekomendasi tersebut karena berbagai alasan. Hal ini juga mencegah rekomendasi berpindah ke statusCLAIMED
.
Informasi tentang status rekomendasi disimpan di kolom stateInfo
entitas Recommendation
. Hal ini mencakup status rekomendasi itu sendiri
dan metadata status per perekomendasikan tambahan.
Saat rekomendasi diubah ke status CLAIMED
, SUCCEEDED
, atau FAILED
,
konten rekomendasi tidak diperbarui, dan rekomendasi memiliki
masa aktif 90 hari sejak perubahan status.
etag
Etag adalah sidik jari unik yang mengidentifikasi status rekomendasi saat ini. Setiap kali rekomendasi berubah, nilai etag baru akan ditetapkan. Nilai ini disimpan di kolom etag
dari entity
Recommender
.
Setelah mengambil rekomendasi dari Pemberi Rekomendasi menggunakan perintah gcloud
atau panggilan API, Anda mereferensikannya dalam operasi berikutnya menggunakan
ID rekomendasi dan etag. Hal ini memastikan bahwa setiap operasi
hanya dilakukan jika rekomendasi belum berubah sejak Anda
mengambilnya terakhir kali.
Prioritas
Prioritas
untuk rekomendasi membantu memberikan indikasi tindakan yang harus ditangani terlebih dahulu.
Kolom ini memiliki nilai P1
, P2
, P3
, dan P4
dengan P4
ditetapkan sebagai prioritas default.
Setiap penyarankan dapat memiliki strategi prioritasnya sendiri yang ditentukan.
Metadata status
Saat mengklaim rekomendasi atau menandainya sebagai berhasil atau gagal, Anda dapat menyertakan metadata tambahan tentang operasi dengan metadata status.
Metadata ditentukan sebagai pasangan key:value
. Contoh:
{
"stateMetadata": {
"priority" : "high",
"tracking_number": "12345" }
}
Pembaruan pada kolom stateMetadata
akan menimpa metadata status yang ada.
Waktu refresh terakhir
Waktu pembaruan terakhir menunjukkan kapan rekomendasi terakhir diperbarui oleh proses pembuatan. Konten rekomendasi mencerminkan status resource pada waktu refresh terakhir.
Contoh
Contoh berikut menunjukkan rekomendasi ukuran untuk instance VM di Compute Engine.
{
"content": {
"operationGroups": [
{
"operations": [
{
"action": "test",
"path": "/machineType",
"resource": "//compute.googleapis.com/projects/example-project/zones/us-central1-a/instances/instance-rightsizing-2",
"resourceType": "compute.googleapis.com/Instance",
"valueMatcher": {
"matchesPattern": ".*zones/us-central1-a/machineTypes/n1-standard-4"
}
},
{
"action": "replace",
"path": "/machineType",
"resource": "//compute.googleapis.com/projects/example-project/zones/us-central1-a/instances/instance-rightsizing-2",
"resourceType": "compute.googleapis.com/Instance",
"value": "zones/us-central1-a/machineTypes/custom-2-5120"
}
]
}
]
},
"description": "Save cost by changing machine type from n1-standard-4 to custom-2-5120.",
"etag": "\"923daeebe926c12f\"",
"recommenderSubtype": "CHANGE_MACHINE_TYPE",
"lastRefreshTime": "2019-06-13T06:44:58Z",
"name": "projects/32428390823/locations/us-central1-a/recommenders/google.compute.instance.MachineTypeRecommender/recommendations/a523ff7e-ed03-4143-a3a5-5b396b99cba9",
"primaryImpact": {
"category": "COST",
"costProjection": {
"cost": {
"currencyCode": "USD",
"units": "-73"
},
"duration": "2592000s"
}
},
"stateInfo": {
"state": "ACTIVE"
}
}
Untuk contoh rekomendasi lainnya, lihat dokumentasi untuk setiap pembuat rekomendasi di Pemberi rekomendasi.
Referensi insight
Referensi ke insight terkait. Referensi menautkan rekomendasi dengan insight terkait, jika ada.
Konfigurasi
Melalui konfigurasi perekomendasikan, Anda dapat melakukan hal berikut:
- Sesuaikan cara insight dan rekomendasi dibuat. Hal ini dilakukan dengan mengubah beberapa parameter konfigurasi yang digunakan untuk menghasilkan insight dan rekomendasi ini.
- Setiap konfigurasi perekomendasikan dimulai dengan beberapa nilai default untuk setiap parameter. Setiap parameter memiliki rentang nilai yang dapat Anda gunakan untuk menyesuaikan konfigurasi.
- Konfigurasi aktif adalah konfigurasi yang terakhir Anda ubah. Untuk setiap perubahan yang dilakukan pada konfigurasi, perlu waktu hingga 48 jam agar konfigurasi diterapkan.
Contoh untuk konfigurasi perekomendasikan adalah menetapkan nilai minimum CPU default atau periode pengamatan untuk membuat rekomendasi yang lebih sesuai dengan beban kerja, aplikasi, dan kebutuhan infrastruktur Anda.
Dengan API konfigurasi, Anda dapat mengambil konfigurasi untuk jenis rekomendasi atau insight. Anda memiliki opsi untuk memperbarui parameter konfigurasi untuk satu project. Setiap jenis insight atau konfigurasi perekomendasikan memerlukan izin tertentu untuk melihat dan mengubah parameter konfigurasi.
Berikut adalah contoh respons yang berisi parameter konfigurasi untuk rekomendasi VM Tidak Ada Aktivitas:
{
"name": "projects/project-number/locations/global/recommenders/google.iam.policy.Recommender/config",
"recommenderGenerationConfig": {
"params": {
"minimum_observation_period": "P90D",
}
},
"etag": "\"2f3c9b65cda6a4ba\"",
"updateTime": "2020-11-03T04:41:15.330351Z"
}