Requête de fichiers journaux d'événements

Objectifs de formation

Une fois cette unité terminée, vous pourrez :

Interroger un objet EventLogFile à l’aide de la Developer Console
Consulter des événements dans le navigateur de fichiers journaux d’événements (ELF) Salesforce
Découvrir les types d’événements EventLogFile

Cette unité repose sur votre compréhension de la console Salesforce Developer Console et du navigateur de fichiers journaux d’événements (ELF). Pour en savoir plus sur ces deux outils, consultez les liens figurant dans la section Ressources de cette unité.

Dans ce module, nous partons du principe que vous êtes un administrateur Salesforce qui dispose des autorisations adéquates pour activer la surveillance des événements. Si vous n’êtes pas un administrateur Salesforce, ce n’est pas grave. Lisez simplement cette section pour découvrir quelles actions votre administrateur réaliserait dans une organisation de production. Vous pouvez également suivre les étapes en utilisant un Trailhead Playground, mais il faut 24 heures pour que les événements apparaissent dans les fichiers journaux.

Consultation des événements dans le navigateur de fichiers journaux d’événements Salesforce

Le navigateur de fichiers journaux d’événements (ELF) Salesforce est une application Web connectée à Salesforce qui permet d’accéder rapidement aux fichiers journaux d’événements. Le navigateur ELF vous permet de facilement trouver et télécharger des événements issus de différentes périodes, sans avoir à écrire une seule ligne de code. Les données contenues dans les fichiers que le navigateur vous fournit peuvent même être visualisées avec Tableau CRM.

Le navigateur ELF Salesforce n’est pas un produit officiel de Salesforce. Nous n’offrons aucune garantie quant à la sûreté, à la sécurité ou à la maintenance du projet ou de l’application déployée.

Assurez-vous que vous disposez de données existantes dans le navigateur ELF. Sinon, générez d’abord des activités d’utilisateurs, afin d’avoir des données à analyser dans l’unité 3. Notez également que vous obtiendrez des informations générales telles que le type d’événement et la date, mais que tous les événements liés à cette date (champ LogFile) ne seront pas visibles dans la Developer Console.

Capture d’écran du navigateur ELF ne renvoyant aucun résultat

Si aucun rapport n’a été exporté depuis votre organisation au cours des dernières 24 heures, la valeur du champ totalSize sera de zéro. Rappelez-vous qu'il faut 24 heures pour que les événements soient disponibles. Vous pouvez exporter un rapport depuis votre organisation et réessayer demain.

Connectez-vous à votre organisation.
Accédez à l’application de navigateur ELF en cliquant sur ce lien : https://salesforce-elf.herokuapp.com.
Cliquez sur Connexion à la production.
Définissez la date de début.
Sélectionnez un type d’événement pour votre recherche ou laissez le type d’événement défini sur Tous.
Cliquez sur Appliquer.

Réalisation d’une requête portant sur des fichiers journaux d’événements dans la Developer Console

Penchons-nous sur l’exemple suivant : un commercial nommé Rob Burgle a quitté votre société il y a quelques semaines et a rejoint un grand concurrent. Vous commencez à perdre des affaires au profit de cette autre société. Vous pensez que Rob a téléchargé un rapport contenant des informations capitales confidentielles et l’a partagé avec son nouvel employeur. Vous ne seriez normalement pas en mesure de confirmer vos soupçons. Toutefois, grâce à la surveillance des événements, vous pouvez rassembler toutes les preuves nécessaires pour rétablir les faits. Intéressons-nous donc à la façon dont fonctionne ce processus.

Il suffit de quelques clics pour ouvrir la Developer Console à partir de Lightning Experience. La Developer Console est un environnement de développement intégré comportant une collection d’outils vous permettant de créer, de déboguer et de tester des applications dans votre organisation Salesforce.

Pour ouvrir la Developer Console à partir de Lightning Experience :

Cliquez sur .
Cliquez sur Developer Console.

Capture d’écran présentant le menu d’accès rapide utilisé pour ouvrir la Developer Console à partir de Lightning Experience

Nous sommes maintenant prêts à ouvrir le fichier EventLogFile pour l’interroger et obtenir les informations.

Cliquez sur Fichier | Ouvrir.
Sous Types d’entités, sélectionnez Objets.
Dans le champ Filter the repository (Filtrer le référentiel), saisissez EventLogFile.
Sélectionnez EventLogFile sous Entités.
Cliquez sur Open.

Ensuite, sélectionnez les champs de votre requête et cliquez sur le bouton Requête.

Capture d’écran affichant les champs à sélectionner pour la requête

Avant de passer à l’étape suivante, assurez-vous que des données d’événements sont présentes dans votre organisation. Si ce n’est pas le cas, exécutez et exportez au moins un rapport, puis attendez 24 heures pour que les données apparaissent.

Enfin, cliquez sur le bouton Exécuter pour terminer la requête.

Capture d’écran affichant les résultats de la requête

Vous pouvez utiliser l’éditeur de requête de la Developer Console pour exécuter une requête SOQL (Salesforce Object Query Language). Le volet Historique affiche vos 10 dernières requêtes, ce qui vous permet de les réutiliser rapidement. Les résultats sont affichés dans une grille appelée Résultats de requête.

La grille Query Results (Résultats de requête) affiche chaque enregistrement sous la forme d’une ligne. Vous pouvez ouvrir, créer, mettre à jour et supprimer des enregistrements sans quitter la Developer Console.

Répertoriage des fichiers journaux d’événements relatifs aux types d’événements

Le champ EventType de l’objet EventLogFile prend en charge les événements. Chaque type d’événement est répertorié dans la référence d’objet Salesforce. Cette dernière contient les champs et leur description, ainsi que des exemples de requêtes à utiliser.

Par exemple, pour le champ DB_TOTAL_TIME, le type d’événement Nombre correspond au temps en nanosecondes nécessaire à la réalisation d’un échange complet avec la base de données, ce qui inclut le temps passé dans le pilote JDBC, la transmission via le réseau vers la base de données et DB_CPU_TIME. En tant qu’administrateur, vous pouvez comparer ce champ à CPU_TIME pour déterminer si les problèmes de performances se trouvent dans la couche de la base de données ou dans votre propre code.

Page Type d’événement de rapport

Les événements de rapport contiennent diverses informations relatives à l’exécution d’un rapport par un utilisateur, notamment la date et l’heure de l’exécution du rapport, son nom, les enregistrements référencés dans celui-ci, le nombre de lignes et de colonnes qu’il contient et son utilisateur d’origine.

Vous pouvez également utiliser l’API REST pour interagir avec les journaux de surveillance des événements. La surveillance des événements est accessible par le biais de l’API SOAP et de l’API REST de la plate-forme Lightning via l’objet EventLogFile. Ainsi, vous êtes en mesure d’intégrer des données de journal à votre propre stockage back-end et à vos propres magasins de données pour rassembler des données de issues de plusieurs organisations et de systèmes disparates.

Dans l’unité suivante, nous allons découvrir comment télécharger et visualiser des fichiers journaux d’événements à l’aide de la surveillance des événements en vue d’obtenir des informations sur le comportement des utilisateurs malveillants.