Health Monitor
Use this page to check that WooCommerce syncing is working and to find out why a sync failed.
Quick steps
- Go to Settings and click WooCommerce Monitor.
- Check Integration Health at the top: Healthy means nothing failed in the last hour.
- Under Recent Sync Logs, look for anything Failed, or a number in the Errors column.
- To read a failed sync's error message, go to Settings > WooCommerce Integration, click View All Logs and open the log.
- On legacy pull, click Test Connection to check Brother POS can reach your site, or Force Sync to run a sync now.
This page covers the Brother POS side, mostly for legacy pull. On Plugin push / pull, use the plugin's Diagnostics page on your WordPress site and your Orders page instead.
Common questions
It says "Missing credentials" but I use the plugin. On plugin push / pull, that message on its own doesn't mean anything is broken. Check the plugin's Diagnostics page.
Will Force Sync overwrite my Brother POS stock or prices? No. It only sends from Brother POS to WooCommerce and brings in new orders.
Do I get an email when a sync fails? No. Failed sync cycles are added to the Activity Log, flagged for review.
More detail: what the monitor covers, and opening it
The WooCommerce Monitor gives a quick view of sync activity between Brother POS and your WooCommerce store. Use it to check that syncs are running, spot failures, and test the connection.
The monitor counts the sync logs Brother POS records during its own sync cycle: order imports, inventory pushes, change detection and product imports. In plugin push / pull mode, catalog pulls and orders sent by the plugin are not recorded here. Check the plugin's Diagnostics page and your Orders page instead.
Opening the Health Monitor
- Go to Settings.
- Click WooCommerce Monitor. This button only appears while the WooCommerce integration is enabled.
More detail: everything on the page, and sync types
What the Page Shows
Integration Health
A status at the top of the page:
| Status | Message | Meaning |
|---|---|---|
| Healthy | WooCommerce integration is working | No failed syncs in the last hour. |
| Warning | Recent sync failures detected | At least one sync failed in the last hour. |
| Error | Missing credentials | The integration is enabled but the Store URL, Consumer Key or Consumer Secret is missing. Stores on plugin push / pull without these fields also see this status. |
| Disabled | WooCommerce not configured / not enabled | The integration isn't set up or is switched off. |
Totals
Four counts covering all sync logs: Total Syncs, Successful, Failed, and Avg Duration (average time of successful syncs, in minutes).
Last 24 Hours and Last 7 Days
The total, successful and failed sync counts for each period.
Recent Sync Logs
The 10 most recent sync logs:
| Column | Description |
|---|---|
| Type | What kind of sync it was (see below) |
| Status | Completed, Failed, or Started (still running) |
| Started | How long ago it began |
| Duration | How long it took |
| Records | How many records it processed |
| Errors | How many records failed |
Configuration
Your Store URL, Polling Interval, whether Products Sync and Orders Sync are on, the Last Product Sync, and whether the Initial Import is completed.
Sync Types
| Type | What it is |
|---|---|
| Product import | Products pulled from WooCommerce into Brother POS (the initial import) |
| Sync cycle | A sync cycle that failed as a whole (on the Sync Logs page this shows as Sync Cycle) |
| Product export | Products sent from Brother POS to WooCommerce |
| Inventory push | Stock levels sent to WooCommerce (legacy pull) |
| Order import | Orders fetched from WooCommerce (legacy pull) |
| Change detection | A check for products edited directly in WooCommerce |
| Auto correction | Changes found by change detection being reverted |
More detail: Test Connection, Force Sync and reading a log
Quick Actions
Test Connection
Checks that Brother POS can reach your WooCommerce store, and shows a message: Connection successful: with your store's name and WooCommerce version, or Connection failed: with the reason. It needs a Consumer Key and Secret, so it only applies to legacy pull.
Force Sync
Runs your normal sync cycle straight away, instead of waiting for the polling interval. Brother POS asks you to confirm, then queues the sync and tells you: "Sync queued. BrotherPOS will send its products, stock and pricing to WooCommerce and check for new orders. Nothing in WooCommerce overwrites your POS products." Refresh the page after a few minutes to see the result.
Force Sync only sends from Brother POS to WooCommerce and brings in new orders. It never pulls products from WooCommerce, so it can't replace your Brother POS stock or prices. It needs a Consumer Key and Secret; without them you see Sync failed: WooCommerce credentials missing.
Reading a Sync Log in Detail
The monitor lists recent logs only. To see the full record:
- Go to Settings > WooCommerce Integration.
- Click View All Logs (or Sync Logs).
- Open a log.
The detail page shows Started At, Completed At, Duration, Records Processed, Records Failed, the Error Message for failed syncs, and a Details breakdown (for example products updated, failed or skipped).
More detail: common health issues, alerts and good habits
Common Health Issues
"Missing credentials"
Cause: The integration is enabled but the Store URL, Consumer Key or Consumer Secret is blank.
Fix: For legacy pull, go to Settings > WooCommerce Integration > Edit Settings and fill them in. On plugin push / pull, this message on its own doesn't mean the plugin connection is broken. Check the plugin's Diagnostics page.
"WooCommerce not enabled"
Fix: Go to Settings > WooCommerce Integration > Edit Settings, tick Enable WooCommerce Integration, and click Save Settings.
"Recent sync failures detected"
Cause: At least one sync failed in the last hour.
Fix: Check Recent Sync Logs, then open the failed log for its error message. Common causes:
- Temporary network problems (these usually clear on the next cycle)
- Your website rate-limiting Brother POS (increase the polling interval)
- API keys revoked or changed (generate new ones in WooCommerce)
- A firewall or security plugin blocking Brother POS (consider plugin push / pull)
Failure Alerts
There are no email alerts for sync failures. When a whole sync cycle fails, it is logged as a Sync cycle failure, and Brother POS also adds a critical entry to the Activity Log, flagged for review.
Best Practices
- Check the Health Monitor regularly, for example as part of opening.
- Look into warnings promptly. A Warning means something failed in the last hour.
- Check failed records. A completed sync can still have records that failed. Look at the Errors column.
- Test after changes. After updating API keys or your store URL, click Test Connection.
What's Next?
- WooCommerce Setup — Review or update your integration settings.
- Plugin Sync (Firewall-Proof) — The recommended plugin-based connection.
- Diagnostics — Troubleshoot problems on the WordPress side.
- Product Sync — How products get to your website.
- Order Sync — How online orders come in.
- Inventory Sync — How stock levels reach WooCommerce.