Echo/Docs

CLI command

analytics

Read recent first-party web and mobile analytics events.

Invocation#

Shell
echo-cli analytics <days>

Inputs and output#

days is required and is any positive whole number; Echo chooses no default and no ceiling. The result contains window_days, since, and every web and mobile event of the window, without user or anonymous identifiers.

State effect#

The command reads web_analytics_events and mobile_analytics_events page by page until every row of the window is read. It does not collect, rewrite, or attribute an event.

Refusals#

  • Without NEXT_PUBLIC_SUPABASE_URL it prints exactly "NEXT_PUBLIC_SUPABASE_URL is not configured" to stderr and exits 1.
  • After the URL is present, without SUPABASE_SERVICE_ROLE_KEY it prints exactly "SUPABASE_SERVICE_ROLE_KEY is not configured" to stderr and exits 1.
  • If Supabase refuses a SELECT, the CLI prints the returned database error message to stderr and exits 1.