Visualizzare i log di Gemini

Questo documento descrive come attivare la raccolta e lo stoccaggio di input, informazioni contestuali e risposte degli utenti quando utilizzi Gemini per Google Cloud. Gemini per Google Cloud non raccoglie né invia a Cloud Logging altre interazioni dell'utente con Gemini per Google Cloud, inclusi i feedback scritti. I dati raccolti vengono inviati a Cloud Logging per la memorizzazione. Puoi esaminare questi dati cercando le voci di log con il tipo di risorsa cloudaicompanion.googleapis.com/Instance.

Questa funzionalità non registra prompt o risposte all'interno di Gemini in Vertex AI. Per attivare i log per Gemini in Vertex AI, consulta Attivare gli audit log di accesso ai dati.

I ruoli IAM (Identity and Access Management) controllano la possibilità per un entità di accedere ai log. Puoi concedere ai principali ruoli predefiniti o creare ruoli personalizzati. Per ulteriori informazioni sulle autorizzazioni richieste, consulta Controllo dell'accesso.

Per impostazione predefinita, Cloud Logging cripta i contenuti archiviati inattivi dei clienti. I dati archiviati nei bucket di log da Logging vengono criptati utilizzando chiavi di crittografia delle chiavi, un processo noto come crittografia dell'involucro. L'accesso ai dati di log richiede l'accesso a queste chiavi di crittografia delle chiavi, che Google gestisce per tuo conto senza che tu debba fare nulla.

La tua organizzazione potrebbe avere requisiti di crittografia avanzati, normativi o relativi alla conformità che la nostra crittografia at-rest predefinita non fornisce. Per soddisfare i requisiti della tua organizzazione, puoi gestire le chiavi di crittografia che proteggono i tuoi dati anziché lasciare che sia Google a farlo.

Per informazioni specifiche sull'utilizzo delle chiavi di crittografia gestite dal cliente (CMEK), inclusi vantaggi e limitazioni, consulta Chiavi di crittografia gestite dal cliente.

Limitazioni

I dati dei log registrati da Gemini in Google Cloud non includono le interazioni degli utenti con i seguenti prodotti:
  • Gemini in BigQuery
  • Gemini in Looker
  • Gemini in Google Security Operations
  • Riquadro Gemini nella console Google Cloud per Database Center

Prima di iniziare

Abilita il logging di Gemini for Google Cloud

Contatta l'assistenza Google Cloud o il tuo rappresentante Google Cloud con l'ID progetto per cui vuoi attivare Gemini per il logging di Google Cloud.

Visualizzare i log di Gemini for Google Cloud

Per visualizzare i log di Gemini for Google Cloud, svolgi una delle seguenti operazioni:

Console Google Cloud

  1. Nella console Google Cloud, vai alla pagina Esplora log:

    Vai a Esplora log

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.

  2. Nella barra degli strumenti, seleziona un progetto della console Google Cloud.
  3. Nella barra degli strumenti, espandi il menu Tutte le risorse e seleziona la risorsa Istanza complementare Cloud AI.

Google Cloud CLI

Esegui questo comando:

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

Voci di log di esempio

Un LogEntry è l'unità di base dei dati in Cloud Logging. Le sezioni seguenti forniscono elenchi di campi trovati in LogEntry per un evento della piattaforma Gemini for Google Cloud, come richieste utente e risposte di Gemini for Google Cloud.

Richieste da parte degli utenti

La tabella seguente mostra un elenco dei campi trovati in una voce di log delle richieste degli utenti.

Campo Valori e note
LogEntry.resource.type Tipo di risorsa di Gemini per Google Cloud: cloudaicompanion.googleapis.com/Instance.
LogEntry.resource.labels.resource_container ID univoco del contenitore delle risorse in cui è stato utilizzato Gemini per Google Cloud.
LogEntry.resource.labels.location Posizione in cui è stato utilizzato Gemini for Google Cloud.
LogEntry.resource.labels.instance_id ID univoco della risorsa in cui è stato utilizzato Gemini per Google Cloud.
LogEntry.labels.method Può essere uno dei seguenti, a seconda di cosa ha invocato logEntry:

CompleteTask: ad esempio, una richiesta di chat da Gemini Code Assist o da un altro servizio Gemini per Google Cloud.

GenerateCode: ad esempio, una richiesta di generazione di codice, ad esempio con una richiesta di trasformazione del codice in Gemini Code Assist.

CompleteCode: ad esempio, una richiesta di completamento del codice durante il lavoro nell'IDE, ad esempio con i suggerimenti in linea in Gemini Code Assist.
LogEntry.labels.product Nome del servizio Gemini for Google Cloud. Se il prodotto Gemini per Google Cloud è Gemini Code Assist, questo valore è code_assist. In caso contrario, questo valore è unknown.
LogEntry.labels.request_id Un identificatore univoco per correlare una richiesta a una voce di log di risposta.
LogEntry.labels.user_id L'identificatore dell'utente che ha avviato questa richiesta.
LogEntry.jsonPayload Il payload della voce di log.
LogEntry.logName Identifica il log.

Il seguente esempio mostra una voce di log di esempio per un evento di prompt della 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"
}

L'esempio seguente mostra una voce RequestLog di esempio per i prompt automatici di suggerimento di codice in linea e per prompt di Gemini per Google Cloud in un file di codice.

I dati del prompt per i suggerimenti di codice in linea utilizzano l'oggetto codeCompletionRequest (come mostrato nell'esempio seguente), mentre la generazione attivata manualmente utilizza 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"
}

Risposte di Gemini for Google Cloud

La tabella seguente mostra i campi di risposta e le descrizioni di Gemini per Google Cloud.

Campo Valori e note
LogEntry.resource.type Tipo di risorsa di Gemini per Google Cloud: cloudaicompanion.googleapis.com/Instance.
LogEntry.resource.labels.resource_container ID univoco del contenitore delle risorse in cui è stato utilizzato Gemini per Google Cloud.
LogEntry.resource.labels.location Posizione in cui è stato utilizzato Gemini for Google Cloud.
LogEntry.resource.labels.instance_id ID univoco della risorsa in cui è stato utilizzato Gemini per Google Cloud.
LogEntry.labels.method Può essere uno dei seguenti, a seconda di cosa ha invocato logEntry:

CompleteTask: ad esempio, una richiesta di chat da Gemini Code Assist o da un altro servizio Gemini per Google Cloud.

GenerateCode: ad esempio, una richiesta di generazione di codice, ad esempio con una richiesta di trasformazione del codice in Gemini Code Assist.

CompleteCode: ad esempio, una richiesta di completamento del codice durante il lavoro nell'IDE, ad esempio con i suggerimenti in linea in Gemini Code Assist.
LogEntry.labels.product Nome del servizio Gemini for Google Cloud. Se il prodotto Gemini per Google Cloud è Gemini Code Assist, questo valore è code_assist. In caso contrario, questo valore è unknown.
LogEntry.labels.request_id Un identificatore univoco per correlare una richiesta a una voce di log di risposta.
LogEntry.labels.user_id L'identificatore dell'utente che ha avviato questa richiesta.
LogEntry.jsonPayload Il payload della voce di log. Eventuali citazioni delle fonti utilizzate per generare la risposta sono incluse in questo oggetto come attribution_context.
LogEntry.logName Identifica il log.

Passaggi successivi