{"id":211,"date":"2026-05-02T00:00:00","date_gmt":"2026-05-02T00:00:00","guid":{"rendered":"https:\/\/fullstackpretender.tech\/?page_id=211"},"modified":"2026-05-03T01:53:19","modified_gmt":"2026-05-03T01:53:19","slug":"reading-sync-logs","status":"publish","type":"page","link":"https:\/\/fullstackpretender.tech\/?page_id=211","title":{"rendered":"Reading Sync Logs"},"content":{"rendered":"\n

Reading Sync Logs<\/h1>\n\n\n\n
\"\"<\/figure>\n\n\n\n

<\/p>\n\n\n\n

How to Read the Sync Details<\/h5>\n\n\n\n

When you expand a sync log, you\u2019ll see a technical breakdown of what happened during that sync. Here\u2019s what each line actually means:<\/p>\n\n\n\n

successCount<\/h5>\n\n\n\n

How many items were successfully synced or updated. If this number is going up, everything is working normally.<\/p>\n\n\n\n

failureCount<\/h5>\n\n\n\n

How many items failed<\/em> to sync. A value of 0<\/strong> means there were no errors. If this number is higher than zero, the system will show the error reasons in errorDetails<\/code>.<\/p>\n\n\n\n

skippedExclusions<\/h5>\n\n\n\n

Items you\u2019ve chosen not<\/strong> to sync (for example, products you\u2019ve excluded). These are intentionally skipped \u2014 not errors.<\/p>\n\n\n\n

skippedUnchanged<\/h5>\n\n\n\n

Items that didn\u2019t need updating because nothing changed since the last sync. This keeps the sync fast and efficient.<\/p>\n\n\n\n

errorDetails<\/h5>\n\n\n\n

If something fails, this section lists the exact reason. If it\u2019s empty ([]<\/code>), there were no errors<\/strong>.<\/p>\n\n\n\n

start<\/h5>\n\n\n\n

The exact timestamp when the sync began. Useful for matching events with your store activity.<\/p>\n\n\n\n

durationSeconds<\/h5>\n\n\n\n

How long the sync took, measured in seconds. Short times mean the system is running efficiently.<\/p>\n\n\n\n

deltaSync<\/h5>\n\n\n\n
    \n
  • true<\/strong> \u2014 only changed items were processed<\/li>\n\n\n\n
  • false<\/strong> \u2014 a full sync was performed Delta syncs are faster and reduce load on your store.<\/li>\n<\/ul>\n\n\n\n
    In short<\/h5>\n\n\n\n

    This section tells you:<\/p>\n\n\n\n

      \n
    • what was updated<\/li>\n\n\n\n
    • what was skipped<\/li>\n\n\n\n
    • whether anything failed<\/li>\n\n\n\n
    • how long it took<\/li>\n\n\n\n
    • whether it was a full sync or a delta sync<\/li>\n<\/ul>\n\n\n\n

      <\/p>\n\n\n\n

      \"\"<\/figure>\n\n\n\n

      Understanding the Sync Trace Log<\/strong><\/p>\n\n\n\n

      The Trace Log provides a chronological record of every action taken during a sync. Each line represents a specific event, including when it occurred, what triggered it, and what the system processed. This information is useful for understanding the flow of a sync and for diagnosing issues if something does not behave as expected.<\/p>\n\n\n\n

      TIME<\/strong> The exact moment the event occurred. This allows you to follow the sequence of actions during the sync.<\/p>\n\n\n\n

      SOURCE<\/strong> Indicates what initiated the action.<\/p>\n\n\n\n

        \n
      • “manual” means you started the sync from the dashboard.<\/li>\n\n\n\n
      • “system” means the automatic scheduler triggered it.<\/li>\n\n\n\n
      • “webhook” means Shopify or QuickBooks notified the system of a change.<\/li>\n<\/ul>\n\n\n\n

        LEVEL<\/strong> Shows the importance or severity of the message.<\/p>\n\n\n\n

          \n
        • “INFO” indicates normal activity.<\/li>\n\n\n\n
        • “WARN” indicates something unexpected but not critical.<\/li>\n\n\n\n
        • “ERROR” indicates a failure that may require attention.<\/li>\n<\/ul>\n\n\n\n

          TYPE<\/strong> Categorises the action being logged. Examples include:<\/p>\n\n\n\n

            \n
          • “trigger” for sync start events<\/li>\n\n\n\n
          • “automap” for item\u2011matching operations<\/li>\n\n\n\n
          • “summary” for the final completion report<\/li>\n<\/ul>\n\n\n\n

            MESSAGE<\/strong> A description of what happened at that step. Some messages include additional structured data showing counts or settings used during the sync.<\/p>\n\n\n\n

            Interpreting the Events in This Example<\/strong><\/p>\n\n\n\n

            Manual sync requested: You manually started a sync from the dashboard. The log confirms whether it will run as a full sync or a delta sync. In this case, fullSync is false, meaning only changed items will be processed.<\/p>\n\n\n\n

            Auto\u2011map reconciliation started: Before syncing, the system checks your Shopify items against QuickBooks to ensure everything is correctly mapped.<\/p>\n\n\n\n

            Auto\u2011map reconciliation completed: This section shows how many items were reviewed and how many were already mapped. It also shows how many items did not have a matching item in QuickBooks. These are not errors; they simply indicate items that cannot be synced until a match exists.<\/p>\n\n\n\n

            Price sync run started: This confirms the direction of the sync (for example, QuickBooks to Shopify), whether a full sync was requested, and that the sync lock is active to prevent multiple syncs from running at the same time.<\/p>\n\n\n\n

            Sync run completed: This is the final summary of the sync. It includes a unique run ID, the start time, the source of the sync, and whether it was a delta sync. If no errors appear in the trace, the sync completed successfully.<\/p>\n\n\n\n

            Summary<\/strong><\/p>\n\n\n\n

            The Trace Log shows the internal steps of the sync process from start to finish. It confirms how the sync was triggered, how items were matched, what direction the sync ran, and whether it completed without errors. If all entries show INFO and no ERROR messages, the sync ran normally.<\/p>\n","protected":false},"excerpt":{"rendered":"

            Reading Sync Logs How to Read the Sync Details When you expand a sync log, you\u2019ll see a technical breakdown […]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":2,"comment_status":"closed","ping_status":"closed","template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"disabled","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"class_list":["post-211","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/fullstackpretender.tech\/index.php?rest_route=\/wp\/v2\/pages\/211","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fullstackpretender.tech\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/fullstackpretender.tech\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/fullstackpretender.tech\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/fullstackpretender.tech\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=211"}],"version-history":[{"count":2,"href":"https:\/\/fullstackpretender.tech\/index.php?rest_route=\/wp\/v2\/pages\/211\/revisions"}],"predecessor-version":[{"id":261,"href":"https:\/\/fullstackpretender.tech\/index.php?rest_route=\/wp\/v2\/pages\/211\/revisions\/261"}],"wp:attachment":[{"href":"https:\/\/fullstackpretender.tech\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=211"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}