Rekomendasi perubahan terbaru

Rekomendasi perubahan terbaru secara otomatis menandai perubahan berisiko yang baru-baru ini dibuat pada resource cloud yang diidentifikasi sebagai penting berdasarkan penggunaannya dan sinyal lainnya untuk membantu mendeteksi dan memitigasi masalah, seperti pemadaman layanan, yang disebabkan oleh kesalahan konfigurasi pada resource cloud yang penting tersebut. Misalnya, jika Anda menghapus project yang sangat sering digunakan, rekomendasi perubahan terbaru dapat membantu mengidentifikasi masalah yang tidak diinginkan dengan memperingatkan Anda secara proaktif tentang risiko yang terkait dengan perubahan tertentu.

Cakupan

Rekomendasi perubahan terbaru hanya mendukung resource dan tindakan yang tercantum dalam tabel berikut.

Resource Tindakan Cakupan/Level Rekomendasi Platform Kriteria yang digunakan untuk menentukan tingkat kepentingan resource
Project Penghapusan Organisasi
  • Google Cloud CLI
  • API Pemberi Rekomendasi
  • Cloud Logging (keikutsertaan)
    		•
  • Penggunaan project (panggilan API, traffic jaringan, dan penggunaan layanan Google Cloud)
  • Penagihan
  • Penggunaan dalam 30 hari terakhir
    		•
    Akun layanan Penghapusan Project
  • Google Cloud CLI
  • API Pemberi Rekomendasi
  • Cloud Logging (keikutsertaan)
    		•
  • Jumlah autentikasi
  • Penggunaan dalam 90 hari terakhir
    		•

    Untuk memberikan masukan terkait kemampuan ini secara keseluruhan atau meminta resource dan tindakan tambahan yang perlu didukung dalam rilis mendatang, lihat Pemecahan masalah, masukan, dan dukungan.

    Sebelum memulai

    1. Aktifkan Recommender API pada satu project penagihan. Kemudian, Anda dapat menggunakan project penagihan yang sama ini untuk mengambil rekomendasi dan insight untuk project lain, seluruh organisasi atau akun penagihan, menggunakan fungsi project penagihan gcloud/API.

    2. Berikan izin pada pengguna atau akun layanan yang akan Anda gunakan untuk mengakses fitur ini.

    Izin

    Agar dapat melihat rekomendasi untuk rekomendasi perubahan terbaru, Anda harus memiliki izin khusus untuk pemberi rekomendasi perubahan terbaru.

    • recommender.cloudRecentChangeRecommendations.get
    • recommender.cloudRecentChangeRecommendations.list
    • recommender.cloudRecentChangeInsights.get
    • recommender.cloudRecentChangeInsights.list

    Anda juga dapat memberikan peran roles/recommender.viewer untuk mencakup izin ini.

    Lihat rekomendasi perubahan terbaru

    Bagian berikut menjelaskan cara melihat rekomendasi perubahan terbaru untuk tindakan yang didukung.

    Penghapusan project

    API

    • ListRecommendation:

      curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: PROJECT_ID " \
"https://recommender.googleapis.com/v1/organizations/ORGANIZATION_ID /locations/global/\
recommenders/google.cloud.RecentChangeRecommender/recommendations"

      Ganti kode berikut:

      • PROJECT_ID : Project ID untuk project tempat Anda mengaktifkan Recommender API.
      • ORGANIZATION_ID : ID organisasi yang Anda inginkan untuk melihat rekomendasi risiko perubahan terbaru.

    • {i>ListInsight<i}:

      curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: PROJECT_ID " \
"https://recommender.googleapis.com/v1/organizations/ORGANIZATION_ID /locations/global/insightTypes/google.cloud.RecentChangeInsight/insights"

      Ganti kode berikut:

      • PROJECT_ID : Project ID untuk project tempat Anda mengaktifkan Recommender API.
      • ORGANIZATION_ID : ID organisasi yang Anda inginkan untuk melihat rekomendasi risiko perubahan terbaru.

    Google Cloud CLI

    • ListRecommendation:

      gcloud recommender recommendations list --recommender=google.cloud.RecentChangeRecommender \
  --organization=ORGANIZATION_ID  --location=global --format=yaml

      Ganti kode berikut:

      • ORGANIZATION_ID : ID organisasi yang Anda inginkan untuk melihat rekomendasi risiko perubahan terbaru.

    • ListInsight

      gcloud recommender insights list --insight-type=google.cloud.RecentChangeInsight \
  --organization=ORGANIZATION_ID  --location=global --format=yaml

      Ganti kode berikut:

      • ORGANIZATION_ID : ID organisasi yang Anda inginkan untuk melihat rekomendasi risiko perubahan terbaru.

    Penghapusan akun layanan

    API

    • ListRecommendation:

      curl -H "Authorization: Bearer $(gcloud auth print-access-token)"\
"https://recommender.googleapis.com/v1/projects/PROJECT_ID /locations/global/\
recommenders/google.cloud.RecentChangeRecommender/recommendations"

      Ganti kode berikut:

      • PROJECT_ID : Project ID untuk project tempat Anda mengaktifkan Recommender API.

    • {i>ListInsight<i}:

      curl -H "Authorization: Bearer $(gcloud auth print-access-token)"\
-H "x-goog-user-project: BILLING_PROJECT_ID "\
"https://recommender.googleapis.com/v1/projects/PROJECT_ID /locations/global/insightTypes/google.cloud.RecentChangeInsight/insights"

      Ganti kode berikut:

      • PROJECT_ID : Project ID untuk project tempat Anda mengaktifkan Recommender API.
      • BILLING_PROJECT_ID : ID project penagihan.

    Google Cloud CLI

    • ListRecommendation:

      gcloud recommender recommendations list --recommender=google.cloud.RecentChangeRecommender \
  --project=PROJECT_ID  --location=global --format=yaml

      Ganti kode berikut:

      • PROJECT_ID : Project ID untuk project tempat Anda mengaktifkan Recommender API.

    • ListInsight

      gcloud recommender insights list --insight-type=google.cloud.RecentChangeInsight \
  --project=PROJECT_ID  --location=global --format=yaml

      Ganti kode berikut:

      • PROJECT_ID : Project ID untuk project tempat Anda mengaktifkan Recommender API.

    Memahami responsnya

    Tabel berikut memberikan deskripsi kolom yang ada dalam objek rekomendasi dan insight.

    Rekomendasi

    Nama kolom Jenis deskripsi
    associatedInsights string Insight yang terkait dengan rekomendasi ini.
    asset objek Berisi nama aset dan jenis aset dari resource terkait.
    etag string Sidik jari RecommenderConfig. Menyediakan penguncian optimis saat memperbarui.
    lastRefreshTime string Stempel waktu terakhir kali rekomendasi diperbarui.
    Stempel waktu dalam format RFC 3339 UTC "Zulu", akurat hingga nanodetik. Contoh: "2022-01-10T22:47:38.421626Z".

    Insights

    Nama kolom Jenis deskripsi
    associatedRecommendations string Rekomendasi yang terkait dengan rekomendasi ini.
    projects/[project_number]/locations/global/recommenders/google.cloud.RecentChangeRecommender/recommendations/[recommendation_id]
    importance objek Berisi alasan mengapa kami menganggap resource ini penting.
    risk objek Berisi beberapa data lain-lain yang relevan dalam menemukan pentingnya resource.
    lastRefreshTime string Stempel waktu terakhir kali rekomendasi diperbarui.
    Stempel waktu dalam format RFC 3339 UTC "Zulu", akurat hingga nanodetik. Contoh: "2022-01-10T22:47:38.421626Z".

    Catat rekomendasi perubahan terbaru

    Secara opsional, Anda dapat menggunakan Cloud Logging untuk membuat log setiap kali rekomendasi perubahan terbaru yang baru muncul. Perlu diperhatikan bahwa log ini adalah log platform, jadi biaya tambahan berlaku untuk log tersebut. Logging dinonaktifkan secara default. Anda harus mengaktifkan logging menggunakan konfigurasi pemberi rekomendasi untuk membuat log.

    Jenis rekomendasi Cakupan Logging
    Penghapusan project berisiko Tingkat organisasi
    Penghapusan akun layanan berisiko Level project

    Cakupan logging untuk rekomendasi sesuai dengan ruang lingkup rekomendasi. Anda dapat mengaktifkan logging untuk organisasi atau project secara terpisah. Konfigurasi logging rekomendasi tidak diwariskan dari organisasi ke project untuk fitur ini. Untuk membuat logging rekomendasi penghapusan akun layanan, Anda harus mengaktifkan logging untuk project yang sesuai.

    Untuk melihat Cloud Logging (jika diaktifkan), Anda memerlukan izin Logs Viewer.

    Konfigurasi logging

    Untuk melihat dan mengupdate konfigurasi pemberi rekomendasi, Anda harus memiliki izin berikut:

    • recommender.cloudRecentChangeRecommenderConfig.get
    • recommender.cloudRecentChangeRecommenderConfig.list
    • recommender.cloudRecentChangeRecommenderConfig.update

    Aktifkan logging

    Gunakan tanda --project untuk mengaktifkan logging untuk project atau tanda --organization untuk mengaktifkan logging untuk organisasi. Contoh berikut menunjukkan cara mengaktifkan logging untuk sebuah project.

    1. Periksa parameter enable_creation_logs di recommenderGenerationConfig:

      gcloud recommender recommender-config describe google.cloud.RecentChangeRecommender \
  --project=PROJECT_ID  --location=global

      Ganti kode berikut:

      • PROJECT_ID : Project ID untuk project tempat Anda mengaktifkan Recommender API.

      Outputnya mirip dengan hal berikut ini:

      <pre class="console">
etag: '"******"'
recommenderGenerationConfig:
  params:
    enable_creation_logs: false
…
</pre>

    2. Buat file config.txt` yang berisi baris berikut:

      {
  "params": {
    "enable_creation_logs": true
  }
}

    3. Perbarui parameter:

      gcloud recommender recommender-config update google.cloud.RecentChangeRecommender \
  --project=PROJECT_ID  --location=global --config-file=config.txt \
  --etag="ETAG "

      Ganti kode berikut:

      • PROJECT_ID : Project ID untuk project tempat Anda mengaktifkan Recommender API.
      • ETAG : Dengan ETAG adalah nilai dari perintah deskripsi sebelumnya.

    Pemecahan masalah, masukan, dan dukungan

    Kirim email ke active-assist-feedback@google.com jika ada masalah teknis, pertanyaan, atau masukan.