workleap 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.
Core Concepts
Correlation Values
Two automatic correlation IDs unify all telemetry platforms:
| ID | Purpose | Honeycomb | LogRocket/Mixpanel |
|---|---|---|---|
| Telemetry Id | Single app load | app.telemetry_id |
Telemetry Id |
| Device Id | Device across sessions | app.device_id |
Device Id |
If LogRocket is enabled, Honeycomb and Mixpanel automatically receive app.logrocket_session_url / LogRocket Session URL.
Platform Roles
- Honeycomb: Distributed traces, performance monitoring, RUM metrics (LCP, CLS, INP)
- LogRocket: Session replay, frontend debugging, user experience investigation
- Mixpanel: Product analytics, event tracking, user behavior insights
Quick Start
import { initializeTelemetry, TelemetryProvider } from "@workleap/telemetry/react";
const telemetryClient = initializeTelemetry({
logRocket: { appId: "your-app-id" },
honeycomb: {
namespace: "your-namespace",
serviceName: "your-service",
apiServiceUrls: [/.+/g],
options: { proxy: "https://your-otel-proxy" }
},
mixpanel: {
productId: "wlp",
envOrTrackingApiBaseUrl: "production"
}
});
// Wrap application
<TelemetryProvider client={telemetryClient}>
<App />
</TelemetryProvider>
Using Platform Clients
// Access via hooks
const telemetryClient = useTelemetryClient();
const honeycombClient = useHoneycombInstrumentationClient();
const logRocketClient = useLogRocketInstrumentationClient();
const mixpanelClient = useMixpanelClient();
const track = useMixpanelTrackingFunction();
Storybook/Testing (Noop Clients)
import { NoopTelemetryClient, TelemetryProvider } from "@workleap/telemetry/react";
const telemetryClient = new NoopTelemetryClient();
<TelemetryProvider client={telemetryClient}>
<Story />
</TelemetryProvider>
Detailed References
- Full API Reference: See references/api.md for complete APIs
- Integration Patterns: See references/integrations.md for platform-specific patterns
- Usage Examples: See references/examples.md for common patterns
Critical Rules
- Use umbrella package - Always use
@workleap/telemetry, not standalone packages - Do not invent APIs - Only use documented APIs from references
- Correlation is automatic - Never manually set Telemetry Id or Device Id
- Noop for non-production - Use
NoopTelemetryClientin Storybook/tests - Privacy matters - Never log PII to LogRocket; use
data-public/data-privateattributes