Eventi dei log dell'app Gemini

Esamina l'interazione degli utenti con l'app Gemini

In qualità di amministratore della tua organizzazione, puoi eseguire ricerche e intervenire sugli eventi dei log dell'app Gemini. Ad esempio, puoi controllare quando gli utenti creano, aggiornano, eliminano, condividono, aprono e interagiscono con Gem e Skill nell'app Gemini.

La possibilità di fare ricerche dipende dalla versione di Google che utilizzi, dai tuoi privilegi amministrativi e dall'origine dati. Puoi fare una ricerca su tutti gli utenti, indipendentemente dalla versione di Google Workspace in uso.

Strumento di controllo e indagine

Per eseguire una ricerca degli eventi dei log, scegli innanzitutto un'origine dati. Poi scegli una o più condizioni per la ricerca.

  1. Nella Console di amministrazione Google, vai a Menu e poi Reporting e poi Controllo e indagine e poi App Gemini.
    Richiede il privilegio amministrativo Controllo e indagine.
  2. Per filtrare gli eventi che si sono verificati prima o dopo una data specifica, seleziona Prima o Dopo per Data. Per impostazione predefinita, vengono mostrati gli eventi degli ultimi 7 giorni. Puoi selezionare un intervallo di date diverso o fare clic su per rimuovere il filtro della data.

  3. Fai clic su Aggiungi un filtro e poi seleziona un attributo. Ad esempio, per filtrare in base a un tipo di evento specifico, seleziona Evento.
  4. Seleziona un operatore e poi seleziona un valore e poi fai clic su Applica.
    • (Facoltativo) Per creare più filtri per la ricerca, ripeti questo passaggio.
    • (Facoltativo) Per aggiungere un operatore di ricerca, sopra Aggiungi un filtro, seleziona AND oppure OR.
  5. Fai clic su Cerca.
    Nota: utilizzando la scheda Filtro, puoi includere semplici coppie di parametri e valori per filtrare i risultati di ricerca. Puoi anche utilizzare la scheda Generatore di condizioni, in cui i filtri sono rappresentati come condizioni con gli operatori AND o OR.

Strumento di indagine sulla sicurezza

Versioni che supportano questa funzionalità: Frontline Standard e Frontline Plus; Enterprise Standard ed Enterprise Plus; Education Standard ed Education Plus; Enterprise Essentials Plus; Cloud Identity Premium. Confronta la tua versione

Per fare una ricerca nello strumento di indagine sulla sicurezza, scegli innanzitutto un'origine dati. Poi scegli una o più condizioni per la ricerca. Per ogni condizione, scegli un attributo, un operatore e un valore.

  1. Nella Console di amministrazione Google, vai a Menu e poi Sicurezza e poi Centro sicurezza e poi Strumento di indagine.

    È necessario disporre del privilegio di amministratore Centro sicurezza.

  2. Fai clic su Origine dati e seleziona App Gemini.
  3. Fai clic su Aggiungi condizione.
    Suggerimento: puoi includere una o più condizioni nella ricerca oppure personalizzarla con query nidificate. Per maggiori dettagli, vedi Personalizza la ricerca con query nidificate.
  4. Fai clic su Attributo e poi seleziona un'opzione. Ad esempio, per filtrare in base a un tipo di evento specifico, seleziona Evento.
    Per un elenco completo degli attributi, consulta la sezione Descrizioni degli attributi più avanti in questa pagina.
  5. Seleziona un operatore.
  6. Inserisci un valore o selezionane uno dall'elenco.
  7. (Facoltativo) Per aggiungere altre condizioni di ricerca, ripeti i passaggi.
  8. Fai clic su Cerca.
    Puoi esaminare i risultati di ricerca dello strumento di indagine in una tabella nella parte inferiore della pagina.
  9. (Facoltativo) Per salvare la tua indagine, fai clic su Salva e poi inserisci un titolo e una descrizione e poi fai clic su Salva.

Note

  • Nella scheda Generatore di condizioni, i filtri sono rappresentati come condizioni con gli operatori AND/OR. Puoi anche utilizzare la scheda Filtro per includere semplici coppie di parametri e valori per filtrare i risultati di ricerca.
  • Se assegni un nuovo nome a un utente, non vedrai i risultati delle query associati al suo nome precedente. Ad esempio, se rinomini NomePrecedente@example.com in NuovoNome@example.com, non verranno restituiti risultati per gli eventi correlati a NomePrecedente@example.com.
  • Puoi cercare dati solo nei messaggi che non sono ancora stati eliminati dal cestino.

Descrizioni degli attributi

Per questa origine dati, puoi utilizzare i seguenti attributi durante la ricerca dei dati sugli eventi dei log: Non tutti gli attributi vengono segnalati per tutti gli eventi. L'elenco non è esaustivo ed è soggetto a modifiche.

Attributo Descrizione
Attore Indirizzo email dell'utente che ha eseguito l'azione.

Nome dell'applicazione dell'attore

Devi aggiungere questa colonna ai risultati di ricerca. Per i passaggi, vai a Gestisci i dati delle colonne dei risultati di ricerca.

Informazioni dettagliate sull'applicazione che ha eseguito l'azione. Nei risultati di ricerca, fai clic su Nome dell'applicazione dell'attore per visualizzare:

  • Nome dell'applicazione dell'attore: nome dell'applicazione che ha eseguito l'azione (compilato per le app di terze parti e per alcune app proprietarie, come Gmail)
  • ID client OAuth dell'attore: identificatore dell'app di terze parti che ha eseguito l'azione
  • Furto d'identità: indica se l'app ha assunto l'identità di un utente

Se esporti queste informazioni in un file con valori separati da virgola (CSV) o in Fogli Google, le informazioni vengono salvate come un unico blocco di testo all'interno di una cella.

Informazioni agente Per una ricerca in base alle informazioni sull'agente AI, seleziona Informazioni agente, quindi seleziona una colonna nidificata: ID agente, Nome agente o Prodotto agente. I risultati della ricerca vengono mostrati nella colonna ID agente.

Fai clic su una voce nei risultati di ricerca per aprire il riquadro Dettagli log e visualizzare:

  • ID agente: l'ID univoco dell'agente
  • Nome agente: il nome visualizzato dell'agente
  • Prodotto agente: il servizio utilizzato dall'agente (supportato solo dal flusso di Google Workspace Studio)

Nota: altri agenti verranno supportati in un secondo momento.

Un identificatore per un Gem Identificatore univoco del Gem associato all'evento.
Un identificatore per una conversazione con Gemini Identificatore univoco della conversazione con Gemini in cui è avvenuta l'interazione.
Un identificatore per una skill Identificatore univoco della skill associata all'evento.
Un identificatore per la richiesta a Gemini Identificatore univoco della richiesta inviata a Gemini.
Da un agente L'azione è stata eseguita con un agente AI (True o False).
Data Data e ora dell'evento, riportate nel fuso orario predefinito del browser.
Descrizione Descrizione dell'evento.
Descrizione del Gem Descrizione del Gem quando viene creato o aggiornato.
Descrizione della skill Descrizione della skill quando viene creata o aggiornata.
Evento

Nome dell'evento inserito nel log.

Eventi dei Gem

  • Chat con Gem condiviso: un utente ha chattato con un Gem condiviso.
  • Gem creato: è stato creato un Gem.
  • Gem eliminato: un Gem è stato eliminato.
  • Gem condiviso: un Gem è stato condiviso con uno o più utenti.
  • Gem aggiornato: un Gem è stato aggiornato.
  • Gem condiviso aperto: è stato aperto un Gem condiviso.

Eventi di abilità

  • Chat con una skill: un utente ha chattato con una skill.
  • Skill creata: è stata creata una skill.
  • Skill eliminata: una skill è stata eliminata.
  • Skill attivata o disattivata: una skill è stata attivata o disattivata.
  • La libreria delle skill è stata modificata: una libreria di skill è stata modificata.
  • Skill condivisa: una skill è stata condivisa con uno o più utenti.
  • Skill aggiornata: una skill è stata aggiornata.
Tipo di evento

Categoria dell'evento registrato:

  • Un Gem è stato modificato
  • Una skill è stata modificata o utilizzata
Indica come è stata modificata una skill Azione di modifica eseguita su una libreria di skill.
Indica se il Gem è condiviso Mostra se il Gem è condiviso con altri utenti.
Indica se la skill è abilitata Mostra se la skill è attiva dopo che un utente l'ha modificata.
Indica se la skill è condivisa Mostra se la skill è condivisa con altri utenti.
Indirizzo IP Indirizzo IP associato all'azione registrata. Si tratta di solito della posizione fisica dell'utente, ma potrebbe anche corrispondere a un server proxy o a un indirizzo VPN (Virtual Private Network, rete privata virtuale).

ASN IP

Devi aggiungere questa colonna ai risultati di ricerca. Per i passaggi, vai a Gestisci i dati delle colonne dei risultati di ricerca.

Numero di sistema autonomo (ASN) dell'indirizzo IP, sottodivisione e regione associati alla voce di log

Per esaminare l'ASN dell'indirizzo IP, la sottodivisione e il codice regione in cui si è verificata l'attività, fai clic sul nome nei risultati di ricerca.

Nome della skill Nome visualizzato della skill associata all'evento.
Risorse

L'elenco delle risorse associate all'azione. Per esaminare i seguenti dettagli, fai clic sulla risorsa:

  • ID risorsa: identificatore della risorsa
  • Titolo della risorsa: il titolo della risorsa
  • Tipo di risorsa: categoria della risorsa
  • Dettagli del proprietario: dettagli sul proprietario della risorsa, inclusi il tipo e l'identità del proprietario
L'account proprietario del gem L'indirizzo email dell'account proprietario del Gem.
Titolo del Gem Titolo visualizzato del Gem associato all'evento.
Utente approvato Indica se un utente ha approvato un'azione eseguita con un agente AI. Mostra True se approvato o rimane vuoto.

ID dispositivo utente

Devi aggiungere questa colonna ai risultati di ricerca. Per i passaggi, vai a Gestisci i dati delle colonne dei risultati di ricerca.

Informazioni dettagliate sul dispositivo che ha eseguito l'azione.

Nei risultati di ricerca, fai clic su ID dispositivo utente per visualizzare:

  • ID dispositivo utente: l'identificatore univoco del dispositivo
  • Tipo di dispositivo utente: il tipo di dispositivo utilizzato (ad esempio DESKTOP_MAC o DESKTOP_WINDOWS)
  • Versione del sistema operativo del dispositivo utente: la versione del sistema operativo installata sul dispositivo

Se esporti queste informazioni in un file con valori separati da virgola (CSV) o in Fogli Google, le informazioni vengono salvate come un unico blocco di testo all'interno di una cella.

Gestire i dati sugli eventi del log

Gestisci i dati delle colonne dei risultati di ricerca

Puoi stabilire quali colonne di dati visualizzare nei risultati di ricerca.

  1. Nell'angolo in alto a destra della tabella dei risultati di ricerca, fai clic su Gestisci colonne .
  2. (Facoltativo) Per rimuovere le colonne attualmente visualizzate, fai clic su Rimuovi .
  3. (Facoltativo) Per aggiungere colonne, fai clic sulla Freccia giù in corrispondenza di Aggiungi nuova colonna e seleziona la colonna di dati che ti interessa.
    Ripeti queste operazioni secondo necessità.
  4. (Facoltativo) Trascina i nomi delle colonne per modificarne l'ordine.
  5. Fai clic su Salva.

Esporta i dati dei risultati di ricerca

Puoi esportare i risultati di ricerca in Fogli o in un file CSV.

  1. Nella parte superiore della tabella dei risultati di ricerca, fai clic su Esporta tutto.
  2. Inserisci un nome e poi fai clic su Esporta.
    L'esportazione viene visualizzata al di sotto della tabella dei risultati di ricerca, in Risultati dell'azione Esporta.
  3. Per visualizzare i dati, fai clic sul nome dell'esportazione.
    L'esportazione si apre in Fogli.

I limiti di esportazione possono variare:

  • Puoi esportare fino a 100.000 righe.
  • Se utilizzi lo strumento di indagine sulla sicurezza, puoi esportare fino a 30 milioni di righe.

Per saperne di più, consulta Esporta i risultati di ricerca.

Quando sono disponibili i dati? Per quanto tempo?

Intervieni in base ai risultati di ricerca

Crea regole di attività e configura avvisi

  • Puoi configurare avvisi basati sui dati degli eventi dei log utilizzando le regole di reporting. Per le istruzioni, vai a Crea e gestisci le regole di reporting.
  • Versioni che supportano questa funzionalità: Frontline Standard e Frontline Plus; Enterprise Standard ed Enterprise Plus; Education Standard ed Education Plus; Enterprise Essentials Plus; Cloud Identity Premium. Confronta la tua versione

    Per contribuire a prevenire, identificare e risolvere in modo efficiente i problemi di sicurezza, puoi creare delle regole di attività per automatizzare azioni nello strumento di indagine sulla sicurezza e configurare degli avvisi. Per configurare una regola, imposta le sue condizioni e specifica quali azioni compiere quando quelle condizioni sono soddisfatte. Per maggiori dettagli, vedi Crea e gestisci le regole di attività.

Intervieni in base ai risultati di ricerca

Versioni che supportano questa funzionalità: Frontline Standard e Frontline Plus; Enterprise Standard ed Enterprise Plus; Education Standard ed Education Plus; Enterprise Essentials Plus; Cloud Identity Premium. Confronta la tua versione

Dopo aver fatto una ricerca nello strumento di indagine sulla sicurezza, puoi agire sui relativi risultati. Ad esempio, puoi fare una ricerca basata sugli eventi dei log di Gmail e quindi utilizzare lo strumento di indagine per eliminare messaggi specifici, metterli in quarantena o inviarli nella Posta in arrivo degli utenti. Per maggiori dettagli, vedi Intervieni in base ai risultati di ricerca.

Gestisci le indagini

Versioni che supportano questa funzionalità: Frontline Standard e Frontline Plus; Enterprise Standard ed Enterprise Plus; Education Standard ed Education Plus; Enterprise Essentials Plus; Cloud Identity Premium. Confronta la tua versione

Visualizza il tuo elenco di indagini

Per visualizzare un elenco delle indagini di tua proprietà e di quelle che sono state condivise con te, fai clic su Visualizza indagini . L'elenco delle indagini ne include i nomi, le descrizioni e i proprietari, nonché la data dell'ultima modifica.

Da questo elenco puoi compiere azioni sulle indagini di tua proprietà, ad esempio eliminare un'indagine. Seleziona la casella accanto a un'indagine, quindi fai clic su Azioni.

Nota: puoi visualizzare le indagini salvate nella sezione Accesso rapido, direttamente sopra l'elenco delle indagini.

Configura le impostazioni per le indagini

Come super amministratore, puoi fare clic su Impostazioni per:

  • Modificare il fuso orario per le indagini. Il fuso orario si applica alle condizioni e ai risultati di ricerca.
  • Attivare o disattivare l'opzione Richiedi revisore. Per maggiori dettagli, vedi Richiedi revisori per azioni collettive.
  • Attivare o disattivare l'opzione Visualizza i contenuti. Questa impostazione consente agli amministratori con i privilegi appropriati di visualizzare i contenuti.
  • Attivare o disattivare l'opzione Abilita motivazione azione.

Per ulteriori dettagli, vedi Configura le impostazioni per le indagini.

Salva, condividi, elimina e duplica le indagini

Per condividere una ricerca con altri utenti o salvarne i criteri, puoi creare e salvare un'indagine e, successivamente, condividerla, duplicarla o eliminarla.

Per informazioni dettagliate, vedi Salva, condividi, elimina e duplica le indagini.