workleap

workleap-telemetry

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

workleap 3 Updated 3mo ago

Resources

1
GitHub

Install

npx skillscat add workleap/wl-telemetry/workleap-telemetry

Install via the SkillsCat registry.

SKILL.md

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 requiredinitializeTelemetry 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