Newer Version Available

This content describes an older version of this product. View Latest

Lightning Usage by Page

Represents standard pages users viewed most frequently in Lightning Experience. This resource is available in REST API version 44.0 and later.

Use this object with the following APIs:

  • Platform
  • Metadata API
  • Tooling API

Syntax

URI
/services/data/vXX.X/sobjects/LightningUsageByPageMetrics
Formats
JSON, XML
HTTP methods
GET
Authentication
Authorization: Bearer token
Parameter Description
EptBin3To5 Number of times that a page loaded between 3-5 seconds.
EptBin5To8 Number of times that a page loaded between 5-8 seconds.
EptBin8To10 Number of times that a page loaded between 8-10 seconds.
EptBinOver10 Number of times that a page loaded over 10 seconds. Includes only valid EPTs (≤ 90 seconds) after filtering.
EptBinUnder3 Number of times that a page loaded under 3 seconds. Includes only valid EPTs (≥ 150 milliseconds) after filtering.
PageName The name of the page.
MetricsDate The date the metric was recorded.
RecordCountEPT Number of records for a page/user where the valid EPT was recorded.
SumEPT Sum of the EPT values for a page/user.
TotalCount Total records for a page/user.
UserId User ID.

Example

1SELECT TotalCount FROM LightningUsageByPageMetrics ORDER BY PageName ASC NULLS FIRST LIMIT 10

Considerations

The data in LightningUsageByPageMetrics is generated by a daily aggregation Spark job. Logs from the entire day, including raw EPT values, are processed and aggregated before being stored in the object. Due to this aggregation process, counts in LightningUsageByPageMetrics may not always match raw Event Monitoring logs.

Note

Raw EPT values (orig_ept) undergo validation and filtering before aggregation as ept values in LightningUsageByPageMetrics. Only valid EPT values are included in aggregated fields such as ValidEptCount, medianEpt, sumEPT, and EPT bucket counts.

A raw EPT value is considered valid if it falls within the following range:

1150 ms ≤ orig_ept ≤ 90,000 ms

If a raw EPT value is outside of this range, it's treated as invalid and gets aggregated as ept = 0.