Loading
Feature Disruption - Service Cloud VoiceRead More
Feature degradation | Gmail Email delivery failureRead More
Set Up and Maintain Your Salesforce Organization
Table of Contents
Filter by (0)Add
Select Filters

          No results
          No results
          Here are some search tips

          Check the spelling of your keywords.
          Use more general search terms.
          Select fewer filters to broaden your search.

            Search all of Salesforce Help
            Search all of Salesforce Help
            Store and Query Log Data with Event Log Objects

            You are here:

            1. Salesforce Help
            2. Docs
            3. Set Up and Maintain Your Salesforce Organization

            Store and Query Log Data with Event Log Objects

            The Event Log Object framework surfaces event data stored in standard objects called Event Log Objects. They store critical event data that you can query via Salesforce Platform APIs. Event log objects contain many but not all events currently represented in the Event Log File framework. Unlike Event Log Files, which surface event data as CSV files, Event Log Objects allow querying of similar data via SOQL.

            Note
            Note As of Spring 25’, the Event Log Object framework only supports SOQL queries.
            Important
            Important This feature is only available to Hyperforce customers. Log data is retained for up to 30 days.
            Available in: Salesforce Classic (not available in all orgs), and Lightning Experience

            Available in: Enterprise, Performance, and Unlimited Editions

            Requires Salesforce Shield or Salesforce Event Monitoring add-on subscriptions.
            User Permissions Needed

            To query and view event log object data:

            View Event Log Object Data

            Event Log Object data is available with minimal delay, enabling earlier detection of security and performance incidents. Write advanced SOQL queries to filter or aggregate log data. Event Log Objects are also available to analyze in CRM Analytics using Salesforce Direct, so you can visualize data in a variety of chart types. Because you can access Event Log Objects via Salesforce Platform APIs, you can build custom applications in the Lightning UI for event specific use cases.

            Note
            Note Event Log Objects provide 30 days of historical data on the go-live date.

            Enable Event Log Objects through the Event Manager tab in Setup:

            1. From Setup, in the Quick Find Box, enter Permission, and select Permission Sets.
            2. Select View Event Log Object Data to access all Event Log Objects. You can alternatively select Event Monitoring User to gain access to all of your Event Monitoring data.
            Example
            Example Sample Queries by Use Case
            • Security Query: Which users are exporting the most rows via reports?

              SELECT UserIdentifier, SUM(RowCount) FROM ReportEventLog WHERE Origin='ReportExported' AND DAY_ONLY(Timestamp) > LAST_N_DAYS:10 Group By UserIdentifier Order by SUM(RowCount) DESC

            • APM Query: What is the number of unexpected apex exceptions grouped by Exception Category?

              SELECT ExceptionCategory, COUNT(Timestamp) FROM ApexUnexpectedExcpEventLog WHERE DAY_ONLY(Timestamp) > LAST_N_DAYS:10 GROUP BY ExceptionCategory ORDER BY COUNT(Timestamp) DESC

            • Product Intelligence Query: What are the most loaded lightning pages?

              SELECT COUNT(Timestamp), PageUrl FROM LightningPageViewEventLog WHERE DAY_ONLY(Timestamp) > LAST_N_DAYS:10 GROUP BY PageUrl ORDER BY COUNT(Timestamp) DESC

            Note
            Note Depending on event delivery and processing time, expect log data to be available to query within 25-45 minutes after the event is logged.
            Important
            Important You can only query 15 days of data at a time using the Timestamp column that’s present on all Event Log Objects. For more details on the limitations and valid formatting for this field see Best Practices and Considerations for Leveraging Event Log Object Data.

            For detailed information about each available Event Log Object, see these topics in the Object Reference for the Salesforce Platform.

            Important
            Important Event log objects aren't available in Government Cloud instances. If your org migrates, there’s potential to lose access to event log object data after migration completion. Contact Salesforce for any issues related to org migration.
            Tip
            Tip Debug and troubleshoot performance issues by correlating logs using the customizable Request Identifier field, available in all Event Monitoring logs. To correlate logs pertaining to an API request call, set the X-SFDC-REQUEST-ID header with a 32 character OTEL compatible TraceId or a 22 -character alphanumeric Id. Using SOQL, search for the Event Monitoring logs with this RequestId to correlate the logs and see the unit of work performed as a part of the API transaction.
            • Analyze Log Data with Salesforce Direct
              Transform your log data into clear, insightful visualizations. Explore Event Log Objects in CRM Analytics with Salesforce Direct using a variety of engaging chart types.
            • Best Practices and Considerations for Leveraging Event Log Object Data
              It’s important to understand the recommended practices and limitations for the Event Log Object framework to get the most out of your log data. Here are some tips to ensure your queries run smoothly.
            • Event Log Objects Analytics
              The new suite of analytic dashboards provide deep, actionable insights across the three critical sectors of an organization: Platform Performance, Data Security, and User Adoption. By providing unprecedented visibility into org activities, users can shift from reactive problem-solving to proactive platform management.
             
            Loading
            Salesforce Help | Article