Melihat log Gemini

Dokumen ini menjelaskan cara mengaktifkan pengumpulan dan penyimpanan input, informasi kontekstual, dan respons pengguna 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 lanjutan 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 logging Google Cloud

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

Melihat log Gemini untuk Google Cloud

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 untuk Google Cloud, seperti permintaan pengguna dan respons Gemini untuk Google Cloud.

Permintaan pengguna

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

Kolom Nilai dan catatan
LogEntry.resource.type Jenis resource Gemini untuk 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 hal berikut, bergantung pada apa yang memanggil logEntry:

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

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 Nama layanan Gemini untuk Google Cloud. Jika produk Gemini untuk Google Cloud adalah Gemini Code Assist, nilai ini adalah code_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": [
            {
              "path": "{/path/to/../current-file.go",
              "segments": [
                {
                  "content": "...Prefix Text..."
                },
                {
                  "content": "...Suffix Text..."
                }
              ],
              "state": ["EDITED"]
            },
            {
              "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"
}

Respons Gemini untuk Google Cloud

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

Kolom Nilai dan catatan
LogEntry.resource.type Jenis resource Gemini untuk 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 hal berikut, bergantung pada apa yang memanggil logEntry:

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

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 Nama layanan Gemini untuk Google Cloud. Jika produk Gemini untuk Google Cloud adalah Gemini Code Assist, nilai ini adalah code_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