How Does AgentExchange App Analytics Data Flow?

As your customers use your managed packages, they produce data. Their usage data is collected daily in our data lake from each Salesforce instance. Usage data arrives to our data lake throughout the day. From time to time, there can be data arrival delays. Also, data builds and timestamps vary by data type. For these reasons, to optimize your data retrieval, plan out your AgentExchange App Analytics query strategy.

Required Editions
Available in: both Salesforce Classic and Lightning Experience
Available in: Enterprise, Performance, Unlimited, and Developer Editions

Because Salesforce instances and your subscribers are located around the world, the time of data collection varies by region. EU (EMEA) data arrives first, then North America (NA) data. Data from Asia Pacific (AP) instances arrives last.

Our AgentExchange App Analytics jobs run on local instance times on a non-peak schedule. Depending on when you query for your data and where your customers are located, sometimes you retrieve 100% of your data at one time. Other times you must issue more queries to retrieve it all.

Your managed package and customer data flows into the Salesforce Data Lake and into an App Analytics query request.

Data delivery to and arrival in our data lake also depends on factors that can affect a given instance, such as the health of the instance or technical dependencies. Ordinarily you can expect all your org data to arrive in the data lake by 23:00 Coordinated Universal Time (UTC) the day after it was recorded. However, occasionally, there can be delays.

Each AgentExchange App Analytics data type is also compiled at different times.

Data TypeBuild InformationExample
Subscriber Snapshots
  • Snapshots use data collected at approximately 01:00 instance local time.
  • Snapshots are generated nightly at approximately 03:00 instance local time.
  • All timestamps are normalized to 00:00 UTCof that day.
For the March 1, 2021 snapshot:
  • All records have this timestamp: 2021-03-01T00:00:00Z.
  • All data normally arrives by March 2, 2021 23:00 UTC.
Package Usage Summaries
  • Summaries use data collected for an entire month.
  • Summaries are built monthly.
  • All timestamps are normalized to 00:00 UTC on the last day of the month.
For the March 2021 summary available on April 1, 2021:
  • All records have this timestamp: 2021-03-31T00:00:00Z.
  • All data normally arrives by April 1, 2021 23:00 UTC.
  • In this example, we recommend that you query for your summary data on April 3, 2021 or later. We recommend a 2-day query delay to ensure that all of your subscriber data from all worldwide instances finished processing.
Package Usage Logs
  • Usage logs use data from the previous day.
  • Usage logs are generated nightly at approximately 05:00 instance local time.
For the March 1, 2021 log file:
  • All records have precise timestamps associated with when that log event occurred.
  • All data normally arrives by March 2, 2021 23:00 UTC.