Console commands

All commands accept --site=<handle>; the reporting ones also accept --period=.

Check the connection

The first thing to run after entering credentials, and the first thing to run when something breaks. It verifies the credentials parse, the token exchange succeeds, and the property answers — three things that fail independently.

php craft telescope/analytics/check

Show one entry’s report

By element ID, or by URL or path:

php craft telescope/analytics/show 1234
php craft telescope/analytics/show /about --period=last90days

This prints the page path being queried, which is what you want when a report looks empty — see Troubleshooting.

Top pages

The property’s most-viewed pages, the same list the Telescope Overview page and the dashboard widget show:

php craft telescope/analytics/top-pages --limit=25

Warm the cache

Pre-fetch reports so editors never wait on a cold cache. Good cron fodder: schedule it a little more often than your cache duration and the control panel is always serving from cache.

php craft telescope/analytics/warm news --limit=100

The argument is a Craft section handle; omit it to warm across sections. Remember each report costs one Data API call per enabled section, so a large --limit on a six-section report is a lot of quota — size it deliberately.

Clear the cache

php craft telescope/analytics/clear-cache

Drops every cached report. Useful after changing path matching or section settings, when you want to see the effect immediately rather than after the cache expires.

A cron example

# Warm the 100 most recent news entries every 5 minutes
*/5 * * * * cd /var/www/example.com && php craft telescope/analytics/warm news --limit=100 >> /dev/null 2>&1