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 perGoogle Cloud. Gemini per Google Cloud non raccoglie né invia a Cloud Logging altre interazioni dell'utente con Gemini per Google Cloud, incluso il feedback scritto. 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 dei clienti archiviati at-rest. I dati archiviati nei bucket di log da Logging vengono criptati utilizzando chiavi di crittografia delle chiavi, una procedura nota come crittografia envelope. 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 avanzata, normativi o relativi alla conformità che la nostra crittografia a riposo 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 Gemini per il Google Cloud logging

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

Visualizza i log di Gemini per Google Cloud

Per visualizzare i log di Gemini for Google Cloud , esegui 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 , ad esempio 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 del 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 per 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 quando si lavora nell'IDE, ad esempio con i suggerimenti in linea in Gemini Code Assist.
LogEntry.labels.product Gemini per il Google Cloud nome del servizio. Se il prodotto Gemini per Google Cloud è Gemini Code Assist, questo valore è code_assist. Se il prodotto Gemini per Google Cloud è Gemini Cloud Assist, questo valore è cloud_assist. In caso contrario, questo valore è unknown.
LogEntry.labels.request_id Un identificatore univoco per correlare una richiesta a una voce del 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 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": [
            {
              "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 per Google Cloud le risposte

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 per 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 quando si lavora nell'IDE, ad esempio con i suggerimenti in linea in Gemini Code Assist.
LogEntry.labels.product Gemini per il Google Cloud nome del servizio. Se il prodotto Gemini per Google Cloud è Gemini Code Assist, questo valore è code_assist. Se il prodotto Gemini per Google Cloud è Gemini Cloud Assist, questo valore è cloud_assist. In caso contrario, questo valore è unknown.
LogEntry.labels.request_id Un identificatore univoco per correlare una richiesta a una voce del 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