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
archiviazione. 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à di un'entità di accedere logaritmi. Puoi concedere ruoli predefiniti alle entità oppure creare ruoli ruoli. 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 logging richiede l'accesso alle chiavi di crittografia della chiave, che Google gestisce le campagne per te 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, vedi Chiavi di crittografia gestite dal cliente.
Limitazioni
I dati dei log registrati da Gemini in Google Cloud 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
-
Per ottenere le autorizzazioni necessarie per visualizzare i log di Gemini per Google Cloud, chiedi all'amministratore di concederti Ruolo IAM Visualizzatore log (
roles/logging.viewer) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.Potresti anche riuscire a ottenere le autorizzazioni richieste tramite la ruoli o altri ruoli predefiniti ruoli.
Esamina i prezzi di Cloud Logging e Prezzi di Gemini per Google Cloud prima del giorno abilitando Gemini per il logging di Google Cloud.
Abilita il logging di Gemini per Google Cloud
Contatta l'assistenza Google Cloud o il tuo rappresentante Google Cloud con l'ID progetto per il quale vuoi abilitare Gemini per il logging di Google Cloud.
Visualizzare i log di Gemini per Google Cloud
Per visualizzare i log di Gemini per Google Cloud:
Console Google Cloud
-
Nella console Google Cloud, vai alla pagina Esplora log:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.
- Nella barra degli strumenti, seleziona un progetto della console Google Cloud.
- Nella barra degli strumenti, espandi il menu Tutte le risorse e seleziona la risorsa Istanza Cloud AI Companion.
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 di
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 utente.
| 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 container della risorsa 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 ciò che è stato richiamato 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 completare codice quando si lavora nell'IDE, come con i suggerimenti in linea in Code Assist. |
LogEntry.labels.product |
Nome del servizio Gemini per 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 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. |
L'esempio seguente mostra un esempio di voce di log per un evento di prompt di 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"
}
Il seguente esempio mostra una voce RequestLog di esempio per qualsiasi prompt di generazione di codice, tra cui prompt di Gemini per Google Cloud in un file di codice, prompt di Gemini per Google Cloud con codice selezionato tramite chat e suggerimento di codice in linea:
{
"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"
"codeGenerationRequest":
input: {
prompt: "Generate some great Python for me."
}
}
"logName": "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Frequest",
"receiveTimestamp": "2023-11-03T23:27:31.255648319Z"
"severity": "INFO"
}
Risposte di Gemini per 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 |
Gemini per il tipo di risorsa di Google Cloud: cloudaicompanion.googleapis.com/Instance. |
LogEntry.resource.labels.resource_container |
ID univoco del container della risorsa 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 ciò che è stato richiamato 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 completare codice quando si lavora nell'IDE, come con i suggerimenti in linea in Code Assist. |
LogEntry.labels.product |
Nome del servizio Gemini per 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 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. |
Passaggi successivi
- Scopri come visualizzare, analizzare e monitorare i log in Google Cloud.
- Scopri di più sul monitoraggio dell'utilizzo di Gemini per Google Cloud.