{"record":{"id":"7d3f1ced89b82f58","repo":"thedotmack/claude-mem","slug":"telemetry-historical-backfill-delivery-errored-wi","errorCode":null,"errorMessage":"Telemetry historical backfill delivery errored; will retry on next worker start","messagePattern":"Telemetry historical backfill delivery errored; will retry on next worker start","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"src/services/telemetry/backfill.ts","lineNumber":679,"sourceCode":"  // resolve while captures are still un-enqueued.\n  await client.shutdown();\n\n  if (errors.length === 0) {\n    writeBackfillMarker({\n      completedAt: new Date().toISOString(),\n      throughDay: lastFullDay,\n      eventCount: events.length,\n      installId,\n      version: BACKFILL_VERSION,\n    });\n    logger.info('SYSTEM', 'Telemetry historical backfill complete', {\n      eventCount: events.length,\n      throughDay: lastFullDay,\n    });\n  } else {\n    // No marker: the next worker start retries with byte-identical events\n    // (deterministic uuid + noon-UTC timestamps make the retry dedupable).\n    logger.warn('SYSTEM', 'Telemetry historical backfill delivery errored; will retry on next worker start', {\n      eventCount: events.length,\n      errorCount: errors.length,\n    });\n  }\n}\n","sourceCodeStart":661,"sourceCodeEnd":685,"githubUrl":"https://github.com/thedotmack/claude-mem/blob/e2d1df569a8f04075d40e92461128ece7cf04c82/src/services/telemetry/backfill.ts#L661-L685","documentation":"After a telemetry historical backfill attempt, some events failed to deliver (errors.length > 0), so the completion marker was not written and the next worker start retries the same window. Retries are safe by design: deterministic uuids plus noon-UTC timestamps let PostHog dedupe the overlap.","triggerScenarios":"Transient network failure or PostHog 5xx/timeout during batch delivery; a subset of per-day batches failing while others succeed, leaving the run incomplete.","commonSituations":"Laptop offline or asleep mid-backfill; firewall or proxy blocking app.posthog.com; rate limiting on large backfills.","solutions":["Ensure outbound HTTPS to app.posthog.com is allowed","Restart the worker — the retry is idempotent thanks to event dedupe","If it keeps failing, capture the per-event errors logged alongside and review proxy/TLS configuration","Note that persistent failure only costs historical telemetry, never functionality"],"exampleFix":null,"handlingStrategy":"retry","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":["Allow outbound HTTPS to app.posthog.com in firewalls and proxies","Restart the worker after network recovery — the retry dedupes overlap by design","Do not disable the worker to silence this; the marker only writes on full success"],"tags":["telemetry","backfill","delivery","retry"],"backgroundTag":"telemetry-delivery-failed","analyzedSha":"e2d1df569a8f04075d40e92461128ece7cf04c82","analyzedAt":"2026-08-20T23:58:13.836Z","contentChangedAt":"2026-08-20T23:58:13.836Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}