> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://doc.ecomx.co/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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.

## Recommended first-day checklist

* 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](https://help.ecomx.co/en/articles/17607643-understanding-the-dashboard)