Skip to main content

pages_trend

Creates, updates, deletes, gets or lists a pages_trend resource.

Overview

Namepages_trend
TypeResource
Idcloudflare.speed.pages_trend

Fields

The following fields are returned by SELECT queries:

Page trend.

NameDatatypeDescription
clsarrayCumulative Layout Shift trend.
fcparrayFirst Contentful Paint trend.
lcparrayLargest Contentful Paint trend.
performanceScorearrayThe Lighthouse score trend.
siarraySpeed Index trend.
tbtarrayTotal Blocking Time trend.
ttfbarrayTime To First Byte trend.
ttiarrayTime To Interactive trend.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_by_zoneselectzone_id, urlregion, deviceType, start, end, tz, metricsLists the core web vital metrics trend over time for a specific page.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
urlstring
zone_idstringThe Cloudflare zone ID.
deviceTypestring
endstring (date-time)
metricsstringA comma-separated list of metrics to include in the results.
regionstring
startstring (date-time)
tzstringThe timezone of the start and end timestamps.

SELECT examples

Lists the core web vital metrics trend over time for a specific page.

SELECT
cls,
fcp,
lcp,
performanceScore,
si,
tbt,
ttfb,
tti
FROM cloudflare.speed.pages_trend
WHERE zone_id = '{{ zone_id }}' -- required
AND url = '{{ url }}' -- required
AND region = '{{ region }}'
AND deviceType = '{{ deviceType }}'
AND start = '{{ start }}'
AND end = '{{ end }}'
AND tz = '{{ tz }}'
AND metrics = '{{ metrics }}'
;