Rekomendasi

Pemberi rekomendasi

Pemberi rekomendasi adalah layanan di Google Cloud yang memberikan rekomendasi pengoptimalan untuk Google Cloud produk dan resource.

Setiap pemberi rekomendasi memungkinkan Anda melihat dan mengelola rekomendasi serta insight-nya menggunakan satu atau beberapa klien berikut:

• Active Assist
• 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 pemberi rekomendasi memiliki ID pemberi rekomendasi unik yang mengidentifikasi layanan. Anda menggunakan ID pemberi rekomendasi saat berinteraksi dengan rekomendasi menggunakan perintah Recommender gcloud, atau REST atau RPC API.

Untuk mengetahui informasi selengkapnya, lihat Pemberi rekomendasi.

Rekomendasi

Rekomendasi adalah saran yang dibuat oleh mesin untuk mengoptimalkan penggunaan resource Cloud Anda. Notifikasi ini mencakup langkah-langkah yang diperlukan untuk menindaklanjuti rekomendasi. Pemberi rekomendasi memberikan rekomendasi berdasarkan penggunaan resource Anda, menggunakan machine learning atau heuristik. Recommender menyimpan rekomendasi menggunakan entity Recommendation.

Rekomendasi memiliki atribut inti berikut:

• Nama
• Deskripsi
• Subjenis pemberi rekomendasi
• Dampak
• Operasi
• Grup operasi
• Info negara bagian
• etag
• Prioritas
• Metadata status
• Waktu refresh terakhir
• Referensi insight
• Konfigurasi

Nama

Nama rekomendasi disimpan di kolom name entitas Recommendation. Ini adalah nama 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 Google Cloud lokasi tempat resource yang terkait dengan rekomendasi berada (misalnya, global atau us-central1-a).
• RECOMMENDER_ID adalah ID pemberi rekomendasi yang memenuhi syarat sepenuhnya (misalnya, google.compute.instance.MachineTypeRecommender).
• RECOMMENDATION_ID adalah ID unik untuk rekomendasi.

Deskripsi

Deskripsi rekomendasi disimpan di kolom description 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, pemberi rekomendasi peran Identity and Access Management memiliki subjenis REPLACE_ROLE dan REMOVE_ROLE. Subtipe baru dapat diperkenalkan ke sistem pemberi rekomendasi yang ada dari waktu ke waktu. Ringkasan ini memberikan daftar semua pemberi rekomendasi yang tersedia. Lihat dokumentasi pemberi rekomendasi untuk mendapatkan informasi selengkapnya tentang subjenis rekomendasi yang tersedia.

Dampak pemberi rekomendasi

Dampak mengukur manfaat yang diproyeksikan dari 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 entitas Recommendation.

• Dampak sekunder bersifat opsional dan disimpan di kolom additionalImpact.

Berikut jenis dampak primer dan sekunder:

• COST: Perkiraan jumlah uang yang diproyeksikan untuk Anda hemat (atau keluarkan) jika Anda menerapkan rekomendasi tertentu. Lihat kolom cost di bagian CostProjection untuk mengetahui detailnya.

• PERFORMANCE: Perkiraan peningkatan atau penurunan performa. Perhatikan bahwa beberapa rekomendasi performa dapat menimbulkan biaya tambahan (misalnya, jika rekomendasi adalah meningkatkan alokasi CPU atau memori pada VM yang kelebihan penggunaan).

• SECURITY: Estimasi peningkatan postur keamanan. Lihat kolom details di bagian SecurityProjection untuk mengetahui detailnya.

• MANAGEABILITY: Perkiraan pengurangan toil manual.

• SUSTAINABILITY: Estimasi pengurangan emisi karbon. Lihat kolom carbon_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 atomik dalam rekomendasi yang disarankan. Operasi dapat mewakili perubahan berikut:

• Menambahkan, menghapus, atau mengganti kolom objek JSON dalam Google Cloud resource.
• Menambahkan, menghapus, atau mengganti kolom array JSON di Google Cloud resource. Elemen array JSON diidentifikasi dengan menentukan filter pada jalur.
• Tambahkan Google Cloud resource baru.
• Menghapus Google Cloud resource.
• Operasi pengujian untuk menunjukkan status asli resource. Operasi pengujian juga dapat digunakan untuk memverifikasi status resource saat ini sebelum menerapkan rekomendasi.
• Menyalin dan memindahkan Google Cloud kolom dan resource.

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 umumnya ditemukan di Google Cloud. Misalnya, rekomendasi IAM melibatkan array bertingkat untuk mencerminkan pemindahan binding peran prinsipal ke peran yang berbeda.

Untuk setiap resource, daftar perubahan (tampilan berbasis perbedaan) dapat dibuat dengan cara berikut:

• Status asli: Operasi pengujian merepresentasikan nilai asli kolom. Bagian ini menampilkan sisi kiri tampilan perbedaan.
• Status yang direkomendasikan: Operasi non-pengujian merepresentasikan perubahan yang direkomendasikan per kolom. Ini mewakili sisi kanan tampilan perbedaan.

Grup operasi

Grup operasi adalah sekumpulan 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 tempat Anda mengubah jenis mesin dalam template instance, dan yang lainnya tempat Anda menerapkan perubahan pada grup instance tertentu.

Karena set operasi pertama harus selesai sebelum set operasi kedua dapat dimulai, set operasi ini ditentukan sebagai dua grup instance terpisah dalam rekomendasi.

Grup operasi dapat mencakup operasi pengujian. Operasi pengujian melakukan pemeriksaan untuk memastikan rekomendasi masih valid. Rekomendasi yang menyarankan perubahan jenis mesin instance VM memiliki operasi pengujian yang memeriksa apakah jenis mesin saat ini sama dengan jenis mesin saat rekomendasi dibuat.

Negara bagian/Provinsi

Rekomendasi melalui banyak transisi status setelah diusulkan. Rekomendasi dapat memiliki status berikut:

• ACTIVE, yang berarti rekomendasi telah dibuat, tetapi tidak ada tindakan yang diambil 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 terhadap rekomendasi tersebut sedang berlangsung. Saat rekomendasi diklaim, Recommender tidak memperbaruinya saat resource berubah.
• SUCCEEDED, yang berarti Anda atau proses lain telah menerapkan rekomendasi ke resource terkait.
• FAILED, yang berarti 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 membatalkannya karena berbagai alasan. Hal ini juga mencegah rekomendasi berpindah ke status CLAIMED.

Informasi tentang status rekomendasi disimpan di kolom stateInfo entitas Recommendation. Hal ini mencakup status rekomendasi itu sendiri dan metadata status per-pemberi rekomendasi tambahan.

Saat rekomendasi diubah ke status CLAIMED, SUCCEEDED, atau FAILED, konten rekomendasi tidak diperbarui, dan rekomendasi memiliki masa berlaku 90 hari sejak waktu perubahan status.

Catatan: Anda tidak dapat menutup rekomendasi atau mengubah status rekomendasi menjadi aktif dari API. Setiap pemberi rekomendasi memberikan opsi untuk menetapkan status ini di konsol Google Cloud .

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 entitas Recommender.

Setelah mengambil rekomendasi dari Recommender menggunakan perintah gcloud atau panggilan API, Anda dapat mereferensikannya dalam operasi berikutnya menggunakan ID rekomendasi dan etag. Hal ini memastikan bahwa setiap operasi hanya dilakukan jika rekomendasi tidak berubah sejak terakhir kali Anda mengambilnya.

Prioritas

Prioritas untuk rekomendasi membantu memberikan indikasi tindakan yang harus ditangani terlebih dahulu. Kolom ini dilengkapi dengan nilai P1, P2, P3, dan P4 dengan P4 ditetapkan sebagai prioritas default. Setiap rekomendasi 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 pemuatan ulang terakhir menunjukkan kapan rekomendasi terakhir dimuat ulang 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 pemberi rekomendasi di Pemberi rekomendasi.

Referensi insight

Referensi ke insight terkait. Referensi menautkan rekomendasi dengan insight terkaitnya, jika ada.

Konfigurasi

Melalui konfigurasi pemberi rekomendasi, Anda dapat melakukan hal berikut:

• Sesuaikan cara analisis dan rekomendasi dibuat. Hal ini dilakukan dengan mengubah beberapa parameter konfigurasi yang digunakan untuk menghasilkan insight dan rekomendasi ini.
• Setiap konfigurasi pemberi rekomendasi 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, diperlukan waktu hingga 48 jam agar konfigurasi diterapkan.

Catatan: Anda hanya dapat mengambil detail konfigurasi untuk jenis pemberi rekomendasi atau insight jika jenis tersebut mendukung setelan konfigurasi ini.

Contoh konfigurasi pemberi rekomendasi adalah menetapkan nilai minimum CPU default atau periode pengamatan untuk membuat rekomendasi yang lebih sesuai dengan workload, aplikasi, dan kebutuhan infrastruktur Anda.

Dengan API konfigurasi, Anda dapat mengambil konfigurasi untuk jenis insight atau pemberi rekomendasi. Anda memiliki opsi untuk memperbarui parameter konfigurasi untuk satu project. Setiap konfigurasi pemberi rekomendasi atau jenis insight memerlukan izin tertentu untuk melihat dan mengubah parameter konfigurasi.

Berikut adalah contoh respons yang berisi parameter konfigurasi untuk pemberi rekomendasi VM yang 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"
}