Renders

Query fragment render analytics — how often each XML fragment is displayed to users.

$ xc analytics renders [options]

Options

In addition to the common options, this command supports fragment filtering:

Option	Abbr	Description
--fragment	-f	Filter by fragment name (supports wildcards)

The --fragment option accepts wildcard patterns. For example, /user/profile/* matches all fragments under the /user/profile/ path.

Full Option Reference

Option	Abbr	Description	Default
--workspace	-w	Workspace to query
--project	-p	Project to query	Current project
--channel	-c	Filter by channel name
--version	-v	Filter by version number
--platform	-t	Filter by device platform
--fragment	-f	Filter by fragment name
--locale	-l	Filter by device locale (user's region setting)
--country		Filter by country
--range	-r	Query the past N days	7
--interval	-i	Aggregation granularity	daily

Output Columns

Column	Description
Period	Time bucket based on the selected interval
Channel	Channel name
Version	Deployment version
Fragment	Fragment name
Platform	Device platform
Locale	Country code from device's locale setting
Country	Country geolocated from device IP
Renders	Number of successful renders
Errors	Number of render errors

Columns corresponding to filters you specify are promoted to headers and removed from the table. Exception: a --fragment filter with a wildcard pattern keeps the Fragment column, since multiple fragments can match.

Examples

# All renders over the past 7 days
$ xc analytics renders

# Renders for a specific fragment
$ xc analytics renders -f /home

# Wildcard fragment filter, past 30 days
$ xc analytics renders -f "/user/*" -r 30

# Production renders, monthly aggregation
$ xc analytics renders -c production -i monthly