Features

Monitoring

Error and request monitoring with @kit/monitoring and Sentry.

Sentry

What It Does

@kit/monitoring wires instrumentation and provider-level monitoring hooks for web apps.

When To Use

You need production error capture and tracing.

Prerequisites

Monitoring env vars configured.

Operational Note

Validate credentials, secrets, and runtime environment values before promoting changes to production.

How To Use

Instrumentation file

apps/dashboard/instrumentation.ts

import { MonitoringProvider } from '@kit/monitoring/provider';
 
export const register = MonitoringProvider.register;
export const onRequestError = MonitoringProvider.captureRequestError;

Client filter wiring

useMonitoringFilters() in app hooks.
Included in app provider filter pipeline.

Env vars

SENTRY_ORG=your-org
SENTRY_PROJECT=your-project
SENTRY_AUTH_TOKEN=sntrys_xxx
NEXT_PUBLIC_SENTRY_DSN=https://xxx.ingest.sentry.io/xxx

Filter API

Monitoring is injected through provider filters, then context-level filters bind auth/error events to the monitoring provider.

Filter	Parameters	Return	Registered By (package file)	Initialized In (app entrypoint)	Environment
`display_app_provider`	`{ analytics?: AnalyticsManager }`	`React.ReactNode`	`kit/monitoring/src/www/filters/use-filters.tsx`	`apps/dashboard/hooks/use-filters.ts` (`useMonitoringFilters`)	`client`
`capture_global_error`	`{ error: { name: string; message: string; stack?: string; cause?: unknown }; digest?: string }`	`null`	`kit/monitoring/src/www/filters/use-filters-with-ctx.tsx`	`MonitoringProvider` context mounted via `display_app_provider`	`client`
`user_signed_in`	`{ userId: string; traits?: Record<string, string> }`	`null`	`kit/monitoring/src/www/filters/use-filters-with-ctx.tsx`	`MonitoringProvider` context mounted via `display_app_provider`	`client`

Init Checklist

Keep useMonitoringFilters() in apps/dashboard/hooks/use-filters.ts.
Ensure app tree includes <FilterApplier name="display_app_provider" ...> in apps/dashboard/components/providers/app-provider.tsx.

MCP Context


capability: monitoring_setup
entrypoints:
  - apps/dashboard/instrumentation.ts
  - kit/monitoring/src/www/filters/use-filters.tsx
  - kit/monitoring/src/www/filters/use-filters-with-ctx.tsx
  - apps/dashboard/hooks/use-filters.ts
  - apps/dashboard/components/providers/app-provider.tsx
  - kit/monitoring/envs.ts
inputs:
  - sentry_credentials
outputs:
  - runtime_error_capture
constraints:
  - dsn and auth token must match Sentry project/org
side_effects:
  - sends errors and traces to monitoring provider

Agent Recipe

Add instrumentation exports.
Initialize monitoring filters in client hooks.
Configure env vars and verify captured events.

Troubleshooting

Missing server traces: verify instrumentation.ts is present in app root.
Missing client events: verify NEXT_PUBLIC_SENTRY_DSN is set.

Analytics

Umami

Configure Umami analytics provider.

Translations

i18next integration pattern used across web apps.

How is this guide?

Last updated on 3/27/2026