apm
16 pages@nais/apm API reference
Every export, signature, and option of the @nais/apm browser SDK — init, captureException, captureMessage, setUser, setContext, captureFeedback, and more.
Create alerts from templates
Turn a Nais APM issue or service into a Grafana alert rule using the built-in error-rate, SLO burn-rate, exception-spike, web-vitals, and new-exception templates.
Enable session replay
Opt in to masked session replay or crash snapshots in @nais/apm, understand the non-overridable masking floor, and make the privacy decision your team owns.
Get backend exceptions into Issues
Get your backend exceptions — JVM (Spring Boot, Ktor) and Node.js — into the Nais APM Issues tab with tight grouping and a stack trace, whether you log to stdout (the default) or export logs over OpenTelemetry.
Get started with Nais APM
Find your service in Nais APM and tour its health overview, issues, backend, database, frontend, traces, and logs.
How Nais APM works
How Nais APM works — where your telemetry comes from and where it lives, why issue grouping is computed statelessly at query time, and what Nais APM deliberately does not do.
Issues and fingerprinting
How Nais APM groups errors into issues — versioned fingerprints, the tiers that decide grouping, and what makes two errors "the same issue".
Make database queries visible
The instrumentation the Nais APM Database tab needs — OpenTelemetry client spans with db.system, and connection-pool metrics for pool health.
Migrate from Sentry to @nais/apm
Move a frontend app off @sentry/* and onto the @nais/apm SDK — a clean, full migration with a concept map, a copy-pasteable recipe, and an honest list of what is different and what is not supported yet.
Nais APM
Nais APM is the curated application performance monitoring app in Grafana. It turns the telemetry your app already ships into service health, issues, and traces — no manual queries.
Next.js quickstart with @nais/apm
Instrument a Next.js app with @nais/apm — client init, an error boundary, route tracking, and opt-in tracing. Covers both the App Router and the Pages Router.
React + Vite quickstart with @nais/apm
Instrument a React single-page app built with Vite using @nais/apm — init at the entry point, an error boundary, and React Router route tracking.
Track frontend errors with @nais/apm
Install the @nais/apm SDK in a browser app, initialize it with zero config, capture exceptions, and see them as issues in Nais APM.
Triage an issue
Resolve, ignore, and assign issues in Nais APM, and understand regressions, mutes, and how triage state is shared across your team.
URL and deep-link contract
The stable URL and query-parameter contract for deep-linking into Nais APM from alerts, runbooks, and shared investigations.
Use log patterns during an incident
Collapse thousands of log lines into a handful of patterns in the Nais APM Logs tab to spot what's new or spiking during an incident.