Melihat log Gemini

Dokumen ini menjelaskan cara mengaktifkan pengumpulan dan penyimpanan input pengguna, informasi kontekstual, dan respons saat Anda menggunakan Gemini untuk Google Cloud. Gemini untuk Google Cloud tidak mengumpulkan atau mengirim ke Cloud Logging interaksi pengguna lainnya yang mungkin dilakukan pengguna dengan Gemini untuk Google Cloud, termasuk masukan tertulis. Data yang dikumpulkan dikirim ke Cloud Logging untuk penyimpanan. Anda dapat meninjau data ini dengan menelusuri entri log dengan jenis resource cloudaicompanion.googleapis.com/Instance.

Fitur ini tidak mencatat perintah atau respons dalam Gemini di Vertex AI. Untuk mengaktifkan log Gemini di Vertex AI, lihat Mengaktifkan log audit Akses Data.

Peran Identity and Access Management (IAM) mengontrol kemampuan akun utama untuk mengakses log. Anda dapat memberikan peran bawaan kepada akun utama, atau membuat peran kustom. Untuk mengetahui informasi selengkapnya tentang izin yang diperlukan, lihat Kontrol akses.

Secara default, Cloud Logging mengenkripsi konten pelanggan yang disimpan dalam penyimpanan. Data yang disimpan di bucket log oleh Logging dienkripsi menggunakan kunci enkripsi kunci, proses yang dikenal sebagai enkripsi amplop. Akses ke data logging Anda memerlukan akses ke kunci enkripsi kunci tersebut, yang dikelola Google untuk Anda tanpa tindakan apa pun dari Anda.

Organisasi Anda mungkin memiliki persyaratan enkripsi peraturan, terkait kepatuhan, atau tingkat lanjut yang tidak disediakan oleh enkripsi default dalam penyimpanan kami. Untuk memenuhi persyaratan organisasi, Anda dapat mengelola kunci enkripsi yang melindungi data Anda, bukan Google.

Untuk informasi spesifik tentang penggunaan kunci enkripsi yang dikelola pelanggan (CMEK), termasuk keuntungan dan batasan, lihat Kunci enkripsi yang dikelola pelanggan.

Batasan

Data log yang dicatat oleh Gemini di Google Cloud tidak menyertakan interaksi pengguna dengan produk berikut:
  • Gemini di BigQuery
  • Gemini in Looker
  • Gemini di Google Security Operations
  • Panel Gemini di konsol Google Cloud untuk Database Center

Sebelum memulai

Mengaktifkan Gemini untuk Google Cloud logging

Hubungi Google Cloud Dukungan atau Google Cloud perwakilan Anda dengan menyertakan project ID yang ingin Anda aktifkan Gemini untuk Google Cloud logging.

Melihat Gemini untuk Google Cloud log

Untuk melihat log Gemini untuk Google Cloud , lakukan salah satu hal berikut:

Konsol Google Cloud

  1. Di konsol Google Cloud, buka halaman Logs Explorer:

    Buka Logs Explorer

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Logging.

  2. Di toolbar, pilih project konsol Google Cloud.
  3. Di toolbar, luaskan menu All resources dan pilih resource Cloud AI Companion Instance.

Google Cloud CLI

Jalankan perintah berikut:

gcloud logging read "resource.type=cloudaicompanion.googleapis.com/Instance" --project PROJECT_ID  --limit 3

Contoh entri log

LogEntry adalah unit dasar data di Cloud Logging. Bagian berikut memberikan daftar kolom yang ditemukan di LogEntry untuk peristiwa platform Gemini for Google Cloud , seperti permintaan pengguna dan respons Gemini for Google Cloud .

Permintaan pengguna

Tabel berikut menunjukkan daftar kolom yang ditemukan di entri log permintaan pengguna.

Kolom Nilai dan catatan
LogEntry.resource.type Gemini untuk jenis resource Google Cloud: cloudaicompanion.googleapis.com/Instance.
LogEntry.resource.labels.resource_container ID unik Penampung Resource tempat Gemini untuk Google Cloud digunakan.
LogEntry.resource.labels.location Lokasi tempat Gemini untuk Google Cloud digunakan.
LogEntry.resource.labels.instance_id ID unik resource tempat Gemini untuk Google Cloud digunakan.
LogEntry.labels.method Dapat berupa salah satu dari berikut ini, bergantung pada apa yang memanggil logEntry:

CompleteTask: misalnya, permintaan chat dari Gemini Code Assist atau layanan Gemini lainnya Google Cloud .

GenerateCode: misalnya, permintaan untuk membuat kode, seperti dengan permintaan transformasi kode dalam Gemini Code Assist.

CompleteCode: misalnya, permintaan untuk menyelesaikan kode saat bekerja di IDE, seperti dengan saran inline dalam Gemini Code Assist.
LogEntry.labels.product Gemini untuk Google Cloud nama layanan. Jika produk Gemini for Google Cloud adalah Gemini Code Assist, nilai ini adalah code_assist. Jika produk Gemini untuk Google Cloud adalah Gemini Cloud Assist, nilai ini adalah cloud_assist. Jika tidak, nilai ini adalah unknown.
LogEntry.labels.request_id ID unik untuk mengaitkan permintaan dengan entri log respons.
LogEntry.labels.user_id ID pengguna yang memulai permintaan ini.
LogEntry.jsonPayload Payload entri log.
LogEntry.logName Mengidentifikasi log.

Contoh berikut menunjukkan contoh entri log untuk peristiwa perintah chat.

{
  "insertId": "654581e30003b19e340bbd96",
  "resource": {
    "type": "cloudaicompanion.googleapis.com/Instance",
    "labels": {
        instance_id: "default"
        location: "global"
        resource_container: "my-project-id"
     }
  },
  "timestamp": "2023-11-03T23:27:31.242078Z",
  "labels": {
    "product": "code_assist",
    "request_id": "4ea1e265-ea5d-4d11-b3c8-39bad9c96326"
    "user_id": "my-user@example.com"
  },
  "jsonPayload" : {
    @type: "type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.RequestLog"
    "taskCompletionRequest":
      input: {
        messages: [{
          author: "USER"
          content: "What are some best practices to save cost on my Google Cloud bill?"
        }]
        preamble: ""
      }
  }
  "logName": "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Frequest",
  "receiveTimestamp": "2023-11-03T23:27:31.255648319Z"
  "severity": "INFO"
}

Contoh berikut menunjukkan contoh entri RequestLog untuk perintah saran kode inline otomatis dan perintah Gemini untuk Google Cloud dalam file kode.

Data perintah untuk saran kode inline menggunakan objek codeCompletionRequest (seperti yang ditunjukkan dalam contoh berikut), sedangkan pembuatan yang dipicu secara manual menggunakan codeGenerationRequest.

{
  "insertId": "654581e30003b19e340bbd96",
  "resource": {
    "type": "cloudaicompanion.googleapis.com/Instance",
    "labels": {
        instance_id: "default"
        location: "global"
        resource_container: "my-project-id"
     }
  },
  "timestamp": "2023-11-03T23:27:31.242078Z",
  "labels": {
    "product": "code_assist",
    "request_id": "4ea1e265-ea5d-4d11-b3c8-39bad9c96326"
    "user_id": "my-user@example.com"
  },
  "jsonPayload" : {
    @type: "type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.RequestLog"
    "codeCompletionRequest": {
      "input_data_context": {
        "additional_context": {
          "files": [
            {
              "language": "go",
              "path": "{/path/to/../current-file.go",
              "segments": [
                {
                  "content": "...Prefix Text..."
                },
                {
                  "content": "...Suffix Text..."
                }
              ],
              "state": ["EDITED"]
            },
            {
              "language": "go",
              "path": "/path/to/../recent-file.go",
              "segments": [
                {
                  "content": "...File Text..."
                }
              ],
              "state": ["RECENTLY_OPENED"]
            }
          ]
        }
      }
    }
  }
  "logName": "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Frequest",
  "receiveTimestamp": "2023-11-03T23:27:31.255648319Z"
  "severity": "INFO"
}

Gemini untuk Google Cloud respons

Tabel berikut menunjukkan Gemini untuk kolom dan deskripsi respons Google Cloud .

Kolom Nilai dan catatan
LogEntry.resource.type Gemini untuk jenis resource Google Cloud: cloudaicompanion.googleapis.com/Instance.
LogEntry.resource.labels.resource_container ID unik Penampung Resource tempat Gemini untuk Google Cloud digunakan.
LogEntry.resource.labels.location Lokasi tempat Gemini untuk Google Cloud digunakan.
LogEntry.resource.labels.instance_id ID unik resource tempat Gemini untuk Google Cloud digunakan.
LogEntry.labels.method Dapat berupa salah satu dari berikut ini, bergantung pada apa yang memanggil logEntry:

CompleteTask: misalnya, permintaan chat dari Gemini Code Assist atau layanan Gemini lainnya Google Cloud .

GenerateCode: misalnya, permintaan untuk membuat kode, seperti dengan permintaan transformasi kode dalam Gemini Code Assist.

CompleteCode: misalnya, permintaan untuk menyelesaikan kode saat bekerja di IDE, seperti dengan saran inline dalam Gemini Code Assist.
LogEntry.labels.product Gemini untuk Google Cloud nama layanan. Jika produk Gemini for Google Cloud adalah Gemini Code Assist, nilai ini adalah code_assist. Jika produk Gemini untuk Google Cloud adalah Gemini Cloud Assist, nilai ini adalah cloud_assist. Jika tidak, nilai ini adalah unknown.
LogEntry.labels.request_id ID unik untuk mengaitkan permintaan dengan entri log respons.
LogEntry.labels.user_id ID pengguna yang memulai permintaan ini.
LogEntry.jsonPayload Payload entri log. Setiap kutipan sumber yang digunakan untuk menghasilkan respons disertakan dalam objek ini sebagai attribution_context.
LogEntry.logName Mengidentifikasi log.

Langkah selanjutnya