Getting Started

Install and open AgentWatch


Install AgentWatch for the Shopify store you want to monitor, then open it from Shopify Admin. AgentWatch authenticates through Shopify and runs as an embedded app.


The app is read-only. It requests report access for aggregate analytics and product access for minimal product title and status snapshots.


Start the Monitor plan


On the Welcome page, select Start 14-day free trial. Shopify opens its hosted plan-selection page, where you can choose monthly or yearly billing and approve the subscription.


The trial starts only after the plan is approved. Shopify manages the charge, trial, billing interval, and cancellation.


Development stores can display an effective price of $0 with labels such as Free to test or Test with this plan. This is expected and does not change the price for production stores.


Add an alert email


After returning to AgentWatch:


  1. Open Settings.
  2. Enter the email address that should receive incident notifications.
  3. Leave Enable email alerts selected.
  4. Select the alert categories you want.
  5. Select Save settings.


AgentWatch sends alerts only for incident openings, critical escalations, and automatic recoveries. It does not email on every monitoring run.


Create the first analytics baseline


In Settings, select Sync 30 completed days. The sync reads the latest 30 completed reporting days and safely stores aggregate metrics.


Do not close the app while a manual operation is running. When it finishes, the


Dashboard shows the latest successful sync time. If one upstream source is temporarily unavailable, AgentWatch retains previously good data and can record the run as Partial.


Run the first health check


Select Run health checks in Settings or on the Health page. Review the latest run and expand View technical details only when you need more context or are preparing a support request.


Manual operations have a one-minute cooldown. If you run the same operation again too quickly, wait for the number of seconds shown in the message.


Review the Dashboard


Return to Dashboard and confirm:


  • The latest analytics sync and health-check times are present.
  • The overall status is shown.
  • Available AI-referred KPIs and channel rows are populated.
  • Any unavailable metric says No data rather than being presented as zero.


Stores without AI-referred or Global Catalog activity can legitimately have empty analytics. Empty data by itself is not an outage.



  • Approve the Monitor subscription.
  • Save an alert email.
  • Sync 30 completed days.
  • Run health checks.
  • Review warnings on the Health page.
  • Confirm the latest timestamps on the Dashboard.
  • Open Products and Incidents to learn their empty states.


Next: Understanding the Dashboard

Updated on: 19/10/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!