Eseguire query nei file del registro eventi

Obiettivi di apprendimento

Al completamento di questa unità, sarai in grado di:

Eseguire una query su un oggetto EventLogFile usando la Developer Console.
Visualizzare gli eventi nel Salesforce Event Log File (ELF) Browser.
Comprendere i tipi di evento EventLogFile.

Questa unità presuppone che tu conosca la Salesforce Developer Console ed Event Log File (ELF) Browser. Per saperne di più su entrambi, consulta i link forniti nella sezione Risorse di questa unità.

In questo modulo partiamo dal presupposto che tu sia un amministratore Salesforce con autorizzazioni appropriate per il monitoraggio degli eventi. Se non sei un amministratore per Salesforce, va bene lo stesso. Continua a leggere per scoprire in che modo il tuo amministratore compie questi passaggi in un'organizzazione di produzione. Puoi seguire il processo anche utilizzando un Trailhead Playground, ma occorrono 24 ore affinché gli eventi vengano visualizzati nei file di registro.

Visualizzare gli eventi in Salesforce Event Log File Browser

Il Salesforce Event Log File (ELF) Browser è un'app web connessa a Salesforce che consente di accedere rapidamente ai file del registro eventi. Con ELF Browser, puoi trovare e scaricare con facilità gli eventi relativi a diversi periodi di tempo senza scrivere una riga di codice. I dati dei file che ricevi dal browser possono essere visualizzati anche con Tableau CRM.

Salesforce ELF Browser non è un prodotto ufficiale Salesforce. Non rilasciamo alcuna garanzia in merito alla sicurezza, alla protezione o alla manutenzione del progetto o dell'app distribuita.

Assicurati di avere dati esistenti ELF Browser, in caso contrario crea qualche attività utente in anticipo. In questo modo avrai dei dati da utilizzare quando arriverai all'Unità 3. Inoltre, tieni presente che questa operazione fornirà informazioni generiche, come il tipo di evento e la data, ma tutti gli eventi di quella data (campo LogFile) non saranno visibili nella Developer Console.

Immagine della schermata di ELF Browser che restituisce zero risultati

Se la tua organizzazione non ha esportato alcun rapporto nelle ultime 24 ore, il valore del campo totalSize sarà zero. Ricorda che occorre attendere 24 ore prima che gli eventi siano disponibili. Puoi esportare un rapporto dalla tua organizzazione e riprovare domani.

Accedi alla tua organizzazione.
Fai clic su questo link per andare all'applicazione ELF Browser: https://salesforce-elf.herokuapp.com.
Fai clic su Production Login (Accesso produzione).
Inserisci la data di inizio.
Seleziona un tipo di evento per la tua ricerca oppure lascia l'impostazione su All (Tutti).
Fai clic su Apply (Applica).

Eseguire una query sui file del registro eventi in Developer Console

Facciamo un esempio: un agente di vendita di nome Rob Burgle ha lasciato la tua azienda qualche settimana fa ed è stato assunto da un'importante azienda della concorrenza. All'improvviso la tua organizzazione comincia a perdere contratti a favore di quell'azienda. Hai il sospetto che Rob abbia scaricato un rapporto contenente informazioni riservate sui lead e lo abbia passato al suo nuovo datore di lavoro. Normalmente non avresti modo di confermare i tuoi sospetti. Con Monitoraggio evento, invece, puoi raccogliere tutte le prove che ti servono per chiarire la faccenda. Vediamo come funziona questo processo.

Bastano pochi clic per aprire Developer Console da Lightning Experience. La Developer Console è un ambiente di sviluppo integrato, con una serie di strumenti che puoi usare per creare, eseguire il debug e testare le applicazioni nella tua organizzazione Salesforce.

Per aprire la Developer Console da Lightning Experience:

Fai clic su .
Fai clic su Developer Console.

Immagine della schermata che mostra il menu di accesso rapido usato per aprire la Developer Console da Lightning Experience

A questo punto puoi aprire EventLogFile per eseguire una query sulle informazioni.

Fai clic su File | Open (File | Apri).
In Entity Type (Tipo entità), seleziona Objects (Oggetti).
Nel campo Filter the repository (Filtra repository), inserisci EventLogFile.
In Entities (Entità), seleziona EventLogFile.
Fai clic su Open (Apri).

Ora seleziona i campi per la tua query e fai clic sul pulsante Query.

Immagine della schermata che mostra i campi che è possibile selezionare per la query

Prima di procedere al passaggio successivo, assicurati che nella tua organizzazione siano presenti dati relativi a eventi. Se non sono disponibili dati, esegui ed esporta almeno un rapporto e attendi 24 ore affinché i dati diventino disponibili.

Infine, fai clic sul pulsante Execute (Esegui) per completare la query.

Immagine della schermata che mostra i risultati della query

Puoi usare Query Editor nella Developer Console per eseguire una query SOQL (Salesforce Object Query Language). Nel riquadro History (Cronologia) sono visualizzate le ultime 10 query, in modo che tu possa riutilizzarle rapidamente. I risultati sono visualizzati nella griglia Query Results (Risultati query).

Nella griglia Query Results (Risultati query) ogni record è visualizzato come riga. Puoi aprire, creare, aggiornare ed eliminare i record senza uscire dalla Developer Console.

Documentazione dei file del registro eventi per i tipi di evento

Il campo EventType nell'oggetto EventLogFile supporta gli eventi. Ogni tipo di evento viene documentato in Salesforce Object Reference (Guida di riferimento agli oggetti Salesforce). Qui puoi vedere i campi e le relative descrizioni e query di esempio da utilizzare.

Per esempio, per il campo DB_TOTAL_TIME, il tipo di evento Number (Numero) corrisponde al tempo in nanosecondi impiegato da un round trip del database, che include il tempo trascorso nel driver JDBC, nel passaggio dalla rete al database, e il valore di DB_CPU_TIME. In quanto amministratore, puoi confrontare questo campo con CPU_TIME per determinare se eventuali problemi di prestazioni sono localizzabili nel database o nel tuo codice.

Pagina Report Event Type (Tipo di evento Report)

Gli eventi Report (Rapporto) contengono informazioni relative a ciò che è accaduto quando un utente ha eseguito un rapporto: informazioni come la data e l'ora, i record a cui si fa riferimento nel rapporto, il numero di righe e di colonne e l'utente di origine, e molto altro.

Puoi anche usare l'API REST per interagire con i registri di Monitoraggio evento; a Monitoraggio evento si accede attraverso le API SOAP e le API REST della piattaforma Lightning tramite l'oggetto EventLogFile. Pertanto, puoi integrare i dati del registro con sistemi di archiviazione e data mart di back-end per mettere in correlazione i dati di più organizzazioni e provenienti dai sistemi più disparati.

Nella prossima unità vedremo come scaricare e visualizzare i file del registro eventi per far avanzare l'indagine sui comportamenti dannosi degli utenti mediante Monitoraggio evento.