Mengonfigurasi logging Gemini Code Assist Standard dan Enterprise

Dokumen ini menjelaskan cara mengonfigurasi logging Standar dan Enterprise Gemini Code Assist untuk project menggunakan konsol Google Cloud atau API.

Batasan

Pencatatan data log Gemini Standard dan Enterprise di Google Cloud dibatasi untuk interaksi pengguna dengan Gemini Code Assist dalam IDE.

Selain itu, Gemini untuk Google Cloud tidak mencatat data untuk Gemini Code Assist Standard dan Enterprise jika telemetri VS Code dinonaktifkan oleh pengguna.

Sebelum memulai

Pastikan Google Cloud project Anda dilampirkan ke akun penagihan.

(Opsional) Berikan izin IAM

Untuk mengonfigurasi logging Gemini Code Assist Standard dan Enterprise, Anda harus memiliki izin Identity and Access Management (IAM) tertentu, yang dijelaskan di bagian berikut. Pastikan izin ini ditambahkan ke peran IAM kustom.

Atau, Anda dapat memberikan peran bawaan IAM Admin Setelan Gemini untuk Google Cloud (roles/cloudaicompanion.settingsAdmin), yang mencakup semua izin yang diperlukan untuk menggunakan semua setelan administrator Gemini untuk Google Cloud Google Cloud.

Mengonfigurasi logging Gemini Code Assist

Bagian berikut memberikan langkah-langkah yang diperlukan untuk mengaktifkan pengumpulan dan penyimpanan aktivitas Gemini Code Assist Standard dan Enterprise di Cloud Logging, termasuk:

  • Perintah dan log respons Gemini Code Assist Standard dan Enterprise, seperti input pengguna, informasi kontekstual, dan respons.

  • Log metadata Gemini Code Assist Standard dan Enterprise, seperti metadata telemetri dan baris kode yang diterima oleh pengguna.

Untuk mengetahui detail selengkapnya tentang kedua jenis log, lihat Melihat log Gemini.

Mengaktifkan logging untuk Gemini Code Assist

Pilih salah satu opsi berikut:

Konsol

  1. Pastikan Anda telah mengaktifkan Cloud Logging API di project.

  2. Pastikan Anda memiliki izin Identity and Access Management (IAM) berikut di project yang memiliki langganan:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • loggingSettings.create
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsCreate
    • cloudaicompanion.settingBindings.loggingSettingsUse
    • cloudaicompanion.instances.queryEffectiveSettingBindings

  3. Di konsol Google Cloud , buka halaman Admin untuk Gemini.

    Buka Gemini untuk Google Cloud

    Halaman Gemini untuk Google Cloud akan dimuat.

  4. Klik Setelan di menu navigasi kiri.

    Halaman Setelan akan dimuat.

  5. (Opsional) Klik Logging untuk metadata Code Assist guna merekam metadata yang dibuat oleh pengguna Gemini Code Assist Standard dan Enterprise dalam project.

  6. (Opsional) Klik Logging untuk perintah dan respons Code Assist untuk mencatat perintah dan respons yang dihasilkan oleh pengguna Gemini Code Assist Standard dan Enterprise dalam project.

  7. Klik Simpan Perubahan.

API

Untuk mengaktifkan logging untuk Gemini Code Assist Standard dan Enterprise, gunakan resource loggingSettings untuk menentukan setelan logging yang Anda inginkan, dan gunakan resource loggingSettings.settingBindings untuk mengikat setelan ke project:

  1. Pastikan Anda telah mengaktifkan Cloud Logging API di project.

  2. Pastikan Anda memiliki izin Identity and Access Management (IAM) berikut di project yang memiliki langganan:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • loggingSettings.create
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsCreate
    • cloudaicompanion.settingBindings.loggingSettingsUse
    • cloudaicompanion.instances.queryEffectiveSettingBindings

  3. Buat setelan dan nilai khusus setelan:

    1. Dapatkan token:

      TOKEN=$(gcloud auth print-access-token)

  4. Aktifkan log Gemini Code Assist Standard dan Enterprise. Log pengguna dan log metadata diaktifkan dengan kolom log_prompts_and_responses dan log_metadata. Jika Anda tidak ingin mengaktifkan salah satu kolom, kecualikan kolom tersebut dari permintaan.

    1. Jalankan perintah berikut untuk membuat setelan:

      curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "log_prompts_and_responses": true,
    "log_metadata": true,
    } ' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings?logging_setting_id=LOGS_SETTING_ID"

      Ganti kode berikut:

      • CONTAINER_PROJECT_NAME: Masukkan project ID project tempat resource binding disimpan. Ini adalah project induk binding.
      • LOGS_SETTING_ID: Masukkan nama setelan unik, seperti gcalm.

      Jika berhasil, perintah akan menampilkan isi respons yang menunjukkan log_prompts_and_responses dan log_metadata ditetapkan ke true:

      {
  "name": "projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/LOGS_SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "log_prompts_and_responses": true,
  "log_metadata": true
}

    2. Jalankan perintah berikut untuk membuat binding setelan log Gemini Code Assist Standard dan Enterprise:

      curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "target": "projects/TARGET_PROJECT_NAME"
    }' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/LOGS_SETTING_ID/settingBindings?setting_binding_id=LOGS_BINDING_ID"

    Ganti kode berikut:

    • TARGET_PROJECT_NAME: Masukkan project target yang akan mengikat binding. Project ini sering kali sama dengan project penampung. Namun, Anda dapat mengikat setelan ke beberapa project sehingga resource setelan tidak perlu diduplikasi.
    • LOGS_BINDING_ID: Gunakan LOGS_SETTING_ID yang sama saat Anda membuat setelan, tetapi tambahkan dengan b1. Misalnya, gunakan gcalmb1.

    Jika berhasil, perintah akan menampilkan metadata operasi dalam format berikut:

    {
  "name": "projects/<var>CONTAINER_PROJECT_NAME</var>/locations/global/operations/operation-1737646069712-62c6140bb04bb-49261230-43701daf",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
    "createTime": "2025-01-23T15:27:50.076075570Z",
    "target": "projects/<var>TARGET_PROJECT_NAME</var>/locations/global/loggingSettings/<var>LOGS_SETTING_ID</var>/settingBindings/<var>LOGS_BINDING_ID</var>",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Menonaktifkan logging untuk Gemini Code Assist

Pilih salah satu opsi berikut:

Konsol

  1. Pastikan Anda memiliki izin Identity and Access Management (IAM) berikut di project yang memiliki langganan:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • loggingSettings.delete
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsDelete
    • cloudaicompanion.settingBindings.loggingSettingsUse
    • cloudaicompanion.instances.queryEffectiveSettingBindings

  2. Di konsol Google Cloud , buka halaman Admin untuk Gemini.

    Buka Gemini untuk Google Cloud

    Halaman Gemini untuk Google Cloud akan dimuat.

  3. Klik Setelan di menu navigasi kiri.

    Halaman Setelan akan dimuat.

  4. Klik Logging untuk metadata Code Assist guna menonaktifkan perekaman metadata dari penggunaan Gemini Code Assist Standard dan Enterprise dalam project.

  5. Klik Simpan Perubahan.

API

Untuk menonaktifkan logging untuk Gemini Code Assist Standard dan Enterprise, gunakan metode loggingSetting.

  1. Pastikan Anda memiliki izin Identity and Access Management (IAM) berikut di project yang memiliki langganan:

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • loggingSettings.create
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsCreate
    • serviceusage.services.enable

  2. Buat setelan dan nilai khusus setelan:

    1. Dapatkan token:

      TOKEN=$(gcloud auth print-access-token)

  3. Jalankan perintah berikut untuk menonaktifkan setelan log Gemini Code Assist Standard dan Enterprise:

      curl -X POST \
    -H "Authorization: Bearer $TOKEN" \
    -H 'Content-Type: application/json' \
    -d '{
      "log_prompts_and_responses": false,
      "log_metadata": false,
      } ' \
    "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings?logging_metadata_id=LOGS_SETTING_ID"

    Ganti kode berikut:

    • CONTAINER_PROJECT_NAME: Masukkan project ID induk.

    • LOGS_SETTING_ID: Masukkan nama setelan yang ada, seperti gcalm.

      Jika berhasil, perintah akan menampilkan isi respons yang menunjukkan log_prompts_and_responses dan log_metadata ditetapkan ke false:

      {
  "name": "projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/LOGS_SETTING_ID",
  "createTime": "2025-01-23T15:22:49.717166932Z",
  "updateTime": "2025-01-23T15:22:49.717166932Z",
  "log_prompts_and_responses": false,
  "log_metadata": false
}

Langkah berikutnya