What problem does it solve?
This Skill eliminates the guesswork and common misconfigurations when setting up OpenTelemetry observability for Next.js applications integrated with Maple, avoiding issues like incorrect SDK usage, Vercel environment propagation quirks, and redundant logging that duplicates OTel events.
Core Features & Use Cases
- Preconfigured Maple OTel Bootstrap: Ready-to-use instrumentation.ts setup using @vercel/otel with inline Maple endpoint and ingest key to bypass Vercel preview build environment quirks.
- LLM Provider Instrumentation: Correct integration of OpenInference for Anthropic and other LLM SDKs, with guidance to avoid duplicate span attributes and manual cost calculation.
- Route-Level Observability Patterns: Best practices for adding business context spans and structured logs using @maple/otel-helpers without cluttering route handler code.
Use case: A developer building a Next.js AI chatbot can use this Skill to automatically capture traces, logs, and metrics for both app routes and LLM calls in Maple, with zero common configuration errors.
Quick Start
Use the maple-nextjs-style skill to configure correct OpenTelemetry instrumentation for your Next.js app integrated with Maple, including LLM provider tracing and route-level span setup.
