maple-nextjs-style

Integrate Maple-style OpenTelemetry tracing, metrics, and logs into Next.js apps.

1.6k|107|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/Makisuo/maple --skill maple-nextjs-style
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maple-nextjs-style
Source: https://github.com/Makisuo/maple/tree/main/skills/maple-nextjs-style
Command: npx skills add https://github.com/Makisuo/maple --skill maple-nextjs-style

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Next.js apps often require robust observability to diagnose performance, reliability, and user experience issues. Maple's OpenTelemetry style provides a framework-backed approach to instrument Next.js projects, enabling end-to-end traces, metrics, and logs that align with Maple ingest.

Core Features & Use Cases

  • Framework-specific bootstrap: use the Vercel OpenTelemetry bootstrap to wire Next.js routes, API routes, and edge functions into Maple.
  • Inline configuration: configure service name, environment attributes, and maple ingest endpoint directly in instrumentation code for predictable behavior across deploys.
  • Compatibility and guidance: supports both Next.js deployments on Vercel and self-hosted environments with native OpenTelemetry APIs, avoiding ad-hoc provider changes.

Quick Start

Set up Maple instrumentation by creating an instrumentation.ts file and calling the inline registerOTel function with the Maple endpoint and ingest key.

Frequently Asked Questions about maple-nextjs-style

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add OpenTelemetry instrumentation to a Next.js app?

To add OpenTelemetry instrumentation to a Next.js app, create an instrumentation.ts file and call the inline registerOTel function with your Maple ingest endpoint and key. This wires Next.js routes, API routes, and edge functions into unified tracing, metrics, and logs.

Can I use Vercel OpenTelemetry bootstrap for Next.js edge runtimes?

Yes, you can use the Vercel OpenTelemetry bootstrap to wire Next.js edge runtimes into Maple. The instrumentation applies framework-specific bootstrap usage to ensure compatibility across pages, API routes, and edge functions.

Does Next.js OpenTelemetry instrumentation work outside of Vercel deployments?

Next.js OpenTelemetry instrumentation works in both Vercel deployments and self-hosted environments. It uses native OpenTelemetry APIs with inline configuration for service name, environment attributes, and ingest endpoint to ensure predictable behavior across any hosting setup.

What is the best way to configure Next.js observability for Maple ingest?

The best way to configure Next.js observability for Maple ingest is through inline endpoint configuration within your instrumentation code. This approach directly sets the service name, environment attributes, and ingest key, avoiding ad-hoc provider changes and ensuring consistent behavior across deploys.

Do I need @vercel/otel to instrument Next.js API routes with OpenTelemetry?

You need @vercel/otel versions to utilize the framework-specific bootstrap for wiring Next.js API routes into Maple. This dependency ensures proper compatibility and guides the OpenTelemetry instrumentation across your application's different runtime environments.

Why are my Next.js OpenTelemetry traces not reaching the Maple ingest endpoint?

Next.js OpenTelemetry traces may not reach the Maple ingest endpoint if the inline configuration in your instrumentation file is incorrect. Ensure you accurately define the service name, environment attributes, and ingest key within the registerOTel function for successful trace delivery.