workleap-telemetry

name	workleap-telemetry
description	Guide for @workleap/telemetry, Workleap's unified telemetry connecting Honeycomb, LogRocket, and Mixpanel with automatic correlation IDs. Use this skill when: (1) Initializing wl-telemetry in a frontend application (2) Correlation values (Telemetry Id, Device Id) and cross-tool data correlation (3) Honeycomb tracing, OpenTelemetry spans, and performance monitoring (4) LogRocket session replay, user identification, and privacy controls (5) Mixpanel analytics, event tracking, and cross-product tracking (6) Configuring wl-telemetry diagnostic loggers (LogRocketLogger) (7) Storybook/test setup with Noop telemetry clients (8) Reviewing or troubleshooting telemetry instrumentation
metadata	{"version":3.2}

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