mapletechlabs/maple/maple-nodejs-style
- community
Checking that the SKILL.md file is still in the repository.
Plain Node.js (Express, Fastify, Hono, Bun) OpenTelemetry style for Maple: NodeSDK + --import bootstrap, native @opentelemetry/api call sites, inline endpoint + ingest key, OTLP HTTP exporters.
Install
npx vskill@latest install mapletechlabs/maple/maple-nodejs-styleSKILL.md
Maple Node.js style
Use @opentelemetry/sdk-node loaded with --import (Bun: --preload) so the SDK starts before any framework code runs.
Run the app with the bootstrap loaded first:
For TypeScript projects, use the loader the repo already uses (tsx, ts-node/esm, native Bun). Do not introduce a new loader. For ESM apps, keep the register(...) hook call and add @opentelemetry/instrumentation to package.json.
Match the installed SDK versions; the wrong shape starts cleanly and then drops data:
- Current
@opentelemetry/sdk-logstakesnew BatchLogRecordProcessor({ exporter }). Older releases took the exporter as the first argument. With the wrong form, every log export throws inside the SDK and no log leaves the process. Check the installed.d.ts. metricReaders(array) replacedmetricReader.
If the app fails at startup after adding the ESM hook, a dependency is incompatible with it. openai@4 is a known case ("you must import 'openai/shims/node'"). Exclude that package from the hook, then instrument it manually or upgrade it:
Bootstrap rules
- HTTP OTLP exporters only, never gRPC. gRPC pulls in native bindings that complicate containers.
getNodeAutoInstrumentations()covers HTTP,fetch(undici), Express, Fastify, pg, MySQL, Redis, and more. Frameworks without their own instrumentation (Hono on@hono/node-server) are still traced at the HTTP server layer. Disable an instrumentation only when it breaks the app:
``ts getNodeAutoInstrumentations({ "@opentelemetry/instrumentation-fs": { enabled: false }, }) ``
getNodeAutoInstrumentations()pulls in about 200 packages. For a small service, listing the specific@opentelemetry/instrumentation-*packages it needs is a fine alternative.- CLIs and one-shot scripts exit before the batch and metric intervals fire:
await sdk.shutdown()before the process ends. - For Bun, use the same SDK with
bun --preload ./telemetry.ts app.ts. Bun ignores Node's module hooks, so some auto-instrumentations do not fire. Add manual spans where auto-instrumentation is blind.
Route handlers and business operations
Use the native API: tracer.startActiveSpan with try / catch / finally for bounded operations, as in maple-onboarding-style.
Logs
Bridge the existing logger through OTLP. Do not replace it. getNodeAutoInstrumentations() already includes the Pino, Winston, and Bunyan instrumentations: they inject trace_id / span_id into records and forward them to the logRecordProcessors configured above. Winston forwarding also needs @opentelemetry/winston-transport installed. console.* is not bridged. The user's logger keeps its current sinks.
Coexistence
If the repo has Sentry, Datadog, New Relic, Honeycomb, Logtail, or a Pino transport, leave them in place alongside Maple.
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/maple-nodejs-style/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/mapletechlabs/maple/maple-nodejs-style)