Mengonfigurasi setelan

Halaman ini menjelaskan cara mengonfigurasi setelan umum untuk Mainframe Assessment Tool dan mengubah fitur AI default untuk penilaian baru.

Setelan yang diubah tidak berlaku untuk penilaian yang ada. Untuk menggunakan setelan yang diubah, buat penilaian baru.

Mengonfigurasi setelan umum

Untuk mengonfigurasi setelan umum untuk penilaian Anda, ikuti langkah-langkah berikut:

  1. Klik ikon setelanSetelan.

  2. Untuk mengedit preferensi Anda untuk Cloud Logging dan Google Analytics, di bagian Setelan umum, lakukan hal berikut:

    • Untuk menonaktifkan Logging, klik tombol Aktifkan Cloud Logging ke posisi nonaktif. Secara default, setelan ini diaktifkan.

      Untuk mengetahui informasi selengkapnya, lihat dokumentasi Cloud Logging.

    • Untuk menonaktifkan Google Analytics, klik tombol Aktifkan Google Analytics ke posisi nonaktif. Secara default, Google Analytics diaktifkan. Perubahan pada setelan ini hanya berlaku setelah Anda memuat ulang halaman.

  3. Lihat kolom Project Google Cloud untuk melihat Google Cloud project ID yang digunakan oleh Mainframe Assessment Tool. Anda tidak dapat mengedit kolom ini di UI. Untuk menggunakan project lain, lihat Mengganti Google Cloud project.

  4. Untuk Tingkat layanan, pilih Gemini Enterprise Agent Platform tingkat layanan. Defaultnya adalah Standar.

    Setelan tingkat layanan menentukan model inferensi dan konsumsi yang diterapkan ke panggilan model Gemini selama penilaian mainframe. Untuk mengetahui informasi selengkapnya tentang tingkat layanan Gemini Enterprise Agent Platform, lihat PayGo.

  5. Klik Simpan setelan.

Mengganti Google Cloud project

Secara default, Mainframe Assessment Tool menggunakan Google Cloud project tempat instance Anda di-deploy. Untuk mengganti project yang digunakan untuk penilaian Anda, ikuti petunjuk untuk lingkungan deployment Anda.

Sebelum memulai

Untuk bersiap mengganti Google Cloud project, selesaikan tugas berikut:

  • Memberikan izin yang diperlukan. Izin yang Anda perlukan bergantung pada cara Anda men-deploy Mainframe Assessment Tool:
    • Di instance VM Compute Engine, Anda memerlukan izin untuk menetapkan metadata kustom pada instance. Untuk mengetahui detail tentang peran yang diperlukan, lihat Menetapkan dan menghapus metadata kustom.
    • Di cluster GKE, Anda memerlukan izin untuk memperbarui deployment di cluster, dan Anda harus mengonfigurasi alat command line kubectl untuk terhubung ke cluster. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi akses cluster untuk kubectl.
  • Memberikan akses project target. Berikan peran yang diperlukan di project target ke akun layanan yang digunakan oleh Mainframe Assessment Tool.

Mengganti project di instance VM Compute Engine

Untuk mengganti Google Cloud project di instance VM Compute Engine, tambahkan kunci metadata MAT_GCP_PROJECT_OVERRIDE dan tetapkan nilainya ke project ID target Anda dengan menjalankan perintah gcloud berikut:

gcloud compute instances add-metadata INSTANCE_NAME \
    --metadata=MAT_GCP_PROJECT_OVERRIDE=PROJECT_ID \
    --zone=ZONE

Untuk menghapus penggantian, hapus kunci metadata dengan menjalankan perintah gcloud berikut:

gcloud compute instances remove-metadata INSTANCE_NAME \
    --keys=MAT_GCP_PROJECT_OVERRIDE \
    --zone=ZONE

Ganti kode berikut:

  • INSTANCE_NAME: nama instance VM Anda.
  • PROJECT_ID: project ID target Anda Google Cloud .
  • ZONE: zona tempat instance VM Anda berada.

Mainframe Assessment Tool kemudian akan kembali ke project ID yang disimpan, jika Anda memilikinya, atau ke project tempat instance di-deploy. Jika Anda menetapkan atau menghapus kunci metadata pada VM yang sedang berjalan, Anda harus memulai ulang VM agar perubahan diterapkan.

Mengganti project di cluster GKE

Untuk mengganti Google Cloud project pada deployment GKE, tetapkan variabel lingkungan MAT_GCP_PROJECT_OVERRIDE pada backend container:

kubectl set env deployment/mat-apps --containers=backend \
    MAT_GCP_PROJECT_OVERRIDE=PROJECT_ID --namespace=VERSION

Untuk menghapus penggantian, batalkan setelan variabel lingkungan dengan menambahkan tanda hubung (-):

kubectl set env deployment/mat-apps --containers=backend \
    MAT_GCP_PROJECT_OVERRIDE- --namespace=VERSION

Ganti kode berikut:

  • PROJECT_ID: project ID target Anda Google Cloud .
  • VERSION: versi Mainframe Assessment Tool yang di-deploy di cluster (misalnya, mainframe-assessment-3-5-0).

Mainframe Assessment Tool kemudian akan kembali ke project ID yang disimpan, jika Anda memilikinya, atau ke project tempat instance di-deploy. Memperbarui variabel lingkungan akan memulai ulang pod dengan penggantian project yang diterapkan. Karena Mainframe Assessment Tool berjalan sebagai satu pod, layanan ini tidak tersedia untuk sementara saat pod baru dimulai.

Mengonfigurasi fitur AI default untuk penilaian baru

Mainframe Assessment Tool memungkinkan Anda menyesuaikan parameter default untuk insight AI dalam penilaian Anda. Secara default, insight AI diaktifkan.

Untuk mengonfigurasi fitur AI dalam penilaian baru, ikuti langkah-langkah berikut:

  1. Klik ikon setelanSetelan.

  2. Untuk membuat ringkasan tingkat paragraf untuk kode COBOL, pilih Ringkasan mendetail.

    Secara default, opsi ini dipilih saat analisis AI diaktifkan.

  3. Untuk membuat kasus pengujian untuk spesifikasi penilaian yang dibuat oleh Gemini, pilih Kasus pengujian.

    Secara default, opsi ini tidak dipilih saat analisis AI diaktifkan.

  4. Untuk Panduan pembuatan tambahan, masukkan teks yang akan ditambahkan ke perintah Gemini selama pembuatan AI.

  5. Klik Simpan setelan.

Memeriksa kesehatan sistem

Mainframe Assessment Tool memeriksa apakah project Anda dapat menjalankan penilaian. Pemeriksaan ini mengonfirmasi bahwa akun layanan memiliki peran IAM yang diperlukan, dan bahwa setiap model Gemini merespons di setiap endpoint yang dapat digunakan oleh penilaian. Mainframe Assessment Tool menjalankan pemeriksaan saat startup. Pemeriksaan ini tidak memblokir penilaian.

Untuk meninjau hasil pemeriksaan, ikuti langkah-langkah berikut:

  1. Klik ikon setelanSetelan.

  2. Di bagian Kesehatan sistem, tinjau hal berikut:

    • Identitas yang diperiksa: akun layanan yang menjalankan pemeriksaan.

    • Izin IAM: apakah akun layanan tersebut memiliki setiap peran yang diperlukan.

    • Model: endpoint tempat setiap model merespons. Untuk model yang tidak merespons, Mainframe Assessment Tool akan memberi nama endpoint, penyebab, dan tindakan yang harus dilakukan.

  3. Opsional: Untuk menjalankan pemeriksaan lagi, misalnya setelah Anda memberikan peran atau mengubah konfigurasi jaringan, klik Periksa ulang.

Jika pemeriksaan menemukan masalah, Mainframe Assessment Tool akan menampilkan notifikasi di setiap halaman hingga Anda memperbaiki atau menutup masalah tersebut.

Jika Cloud Resource Manager API tidak diaktifkan di project Anda, Mainframe Assessment Tool tidak dapat memverifikasi izin IAM dan melaporkannya di bagian Kesehatan sistem. Untuk mengaktifkan API, lihat Mengaktifkan API.

Opsional: Melakukan tindakan

Bagian ini menjelaskan cara melakukan tindakan, seperti menghapus cache Gemini dan mendownload log Anda.

Untuk melakukan tindakan, ikuti langkah-langkah berikut:

  1. Klik ikon setelanSetelan.

  2. Untuk menghapus cache Gemini, klik Hapus cache model.

  3. Untuk mendownload log Mainframe Assessment Tool, klik Download paket dukungan.

    Paket dukungan berisi log Mainframe Assessment Tool sebagai file zip, yang dapat Anda bagikan kepada Google Cloud support untuk memecahkan masalah.

Menonaktifkan insight AI untuk penilaian

Anda dapat menonaktifkan analisis AI untuk mencegah insight AI muncul di halaman Penilaian.

Untuk menonaktifkan analisis AI untuk penilaian, ikuti langkah-langkah berikut:

  1. Di bagian Fitur AI default dalam penilaian baru, hapus centang Aktifkan insight AI.

  2. Klik Simpan setelan.

Melacak biaya Agent Platform menggunakan label metadata kustom

Mainframe Assessment Tool otomatis menambahkan label metadata kustom ke semua permintaan Agent Platform untuk membantu Anda melacak dan menganalisis biaya. Dalam laporan penagihan, Anda dapat menggunakan label ini untuk memfilter biaya guna lebih memahami dan mengoptimalkan penggunaan Agent Platform. Biaya diperbarui dalam laporan penagihan dalam waktu 24 jam setelah penggunaan, tetapi dalam beberapa kasus, prosesnya dapat memerlukan waktu lebih lama.

Filter biaya dalam laporan penagihan Anda dengan label berikut:

  • mat-version: versi Mainframe Assessment Tool.
  • mat-host: lingkungan host instance Mainframe Assessment Tool. Misalnya, VM Compute Engine atau Google Kubernetes Engine.
  • mat-action-type: jenis tindakan yang dilakukan oleh Mainframe Assessment Tool.
  • mat-schema: jenis aset yang diproses. Misalnya, COBOL atau JCL.
  • mat-target: target deployment instance Mainframe Assessment Tool.
  • mat-run-id: ID unik penilaian.

Untuk melacak penggunaan dengan menggunakan satu atau beberapa filter ini dalam laporan penagihan, lihat Menggunakan filter untuk menyaring data.

Untuk mengetahui informasi selengkapnya tentang label di Agent Platform, lihat Label metadata kustom.

Langkah berikutnya