Workleap Telemetry (wl-telemetry)

@workleap/telemetry is an umbrella package that integrates Honeycomb, LogRocket, and Mixpanel with consistent correlation IDs for unified debugging and analysis.

Critical Rules

1. Use umbrella package — Always use @workleap/telemetry, not standalone packages
2. Do not invent APIs — Only use documented APIs from references
3. Correlation is automatic — Never manually set Telemetry Id or Device Id; never create your own TelemetryContext instances
4. Noop for non-production — Use NoopTelemetryClient in Storybook/tests
5. Privacy matters — Never log PII to LogRocket; use data-public/data-private attributes
6. productFamily is required — initializeTelemetry requires "wlp" or "sg" as the first argument

Reference Guide

For detailed documentation beyond the rules above, consult:

• references/api.md — Initialization options, TelemetryClient properties, Honeycomb/LogRocket/Mixpanel client APIs, React hooks, Noop clients, LogRocketLogger
• references/integrations.md — Platform-specific configuration, Honeycomb tracing patterns, LogRocket privacy and user identification, Mixpanel event tracking, cross-platform correlation workflows
• references/examples.md — Full application setup, Storybook/test configuration, user identification, custom Honeycomb traces, Mixpanel tracking patterns, logging configuration, troubleshooting