Rekomendasi perubahan terbaru

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

Cakupan

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

Resource Tindakan Cakupan/Tingkat Rekomendasi Platform Kriteria yang digunakan untuk menentukan tingkat kepentingan resource
Project Penghapusan Organisasi
  • Google Cloud CLI
  • Recommender API
  • Cloud Logging (opt-in)
  • Penggunaan project (panggilan API, traffic jaringan, dan penggunaan layanan Google Cloud )
  • Penagihan
  • Penggunaan dalam 30 hari terakhir
  • Akun layanan Penghapusan Project
  • Google Cloud CLI
  • Recommender API
  • Cloud Logging (opt-in)
  • Jumlah autentikasi
  • Penggunaan dalam 90 hari terakhir
  • Untuk memberikan masukan tentang kemampuan ini secara keseluruhan atau meminta sumber daya dan tindakan tambahan yang ingin Anda lihat didukung dalam rilis mendatang, lihat Pemecahan masalah, masukan, dan dukungan.

    Sebelum memulai

    1. Aktifkan Recommender API di 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 billing-project gcloud/API.

    2. Beri izin pada pengguna atau akun layanan yang akan digunakan untuk mengakses fitur ini.

    Izin

    Untuk melihat 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.

    Melihat 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 project tempat Anda telah mengaktifkan Recommender API.
      • ORGANIZATION_ID : ID organisasi yang ingin Anda lihat rekomendasi risiko perubahan terbaru.
    • ListInsight:

      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 project tempat Anda telah mengaktifkan Recommender API.
      • ORGANIZATION_ID : ID organisasi yang ingin Anda lihat 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 ingin Anda lihat 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 ingin Anda lihat 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 project tempat Anda telah mengaktifkan Recommender API.
    • ListInsight:

      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 project tempat Anda telah 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 project tempat Anda telah 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 project tempat Anda telah mengaktifkan Recommender API.

    Memahami respons

    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 resource terkait.
    etag string Sidik jari RecommenderConfig. Menyediakan penguncian optimistis saat memperbarui.
    lastRefreshTime string Stempel waktu saat rekomendasi terakhir diperbarui.
    Stempel waktu dalam format RFC 3339 UTC "Zulu", akurat hingga nanodetik. Contoh: "2022-01-10T22:47:38.421626Z".

    Insight

    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 menentukan bahwa resource ini penting.
    risk objek Berisi beberapa data lain-lain yang relevan dalam menemukan pentingnya resource.
    lastRefreshTime string Stempel waktu saat rekomendasi terakhir diperbarui.
    Stempel waktu dalam format RFC 3339 UTC "Zulu", akurat hingga nanodetik. Contoh: "2022-01-10T22:47:38.421626Z".

    Mencatat rekomendasi perubahan terbaru

    Secara opsional, Anda dapat menggunakan Cloud Logging untuk membuat log setiap kali ada rekomendasi perubahan terbaru yang baru. Perhatikan bahwa log ini adalah log platform, sehingga biaya tambahan berlaku untuk log tersebut. Logging dinonaktifkan secara default. Anda harus mengaktifkan logging menggunakan konfigurasi recommender untuk membuat log.

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

    Cakupan logging untuk rekomendasi sesuai dengan cakupan rekomendasi. Anda dapat mengaktifkan logging untuk organisasi atau project secara terpisah. Konfigurasi logging rekomendasi tidak diwarisi dari organisasi ke project untuk fitur ini. Untuk membuat log 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 memperbarui konfigurasi recommender, 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 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 project tempat Anda telah 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 project tempat Anda telah mengaktifkan Recommender API.
      • ETAG : Dengan ETAG adalah nilai dari perintah describe sebelumnya.

    Pemecahan masalah, masukan, dan dukungan

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