Skip to main content

Getting Started with ɳSentry

Install and configure ɳSentry observability bundle for your nSelf deployment

ɳSentry is a comprehensive observability and incident management bundle for nSelf deployments. Monitor uptime, track errors, manage incidents, and maintain SLOs — all self-hosted.

:::tip[Prefer hosted?] ɳSentry is also available as a hosted SaaS at sentry.nself.org — no self-hosting required, with a free tier to start. See ɳSentry SaaS. :::

Installation

Prerequisites

  • nSelf CLI v1.1.1 or later
  • Valid ɳSentry bundle license (included in ɳSelf+ or standalone $0.99/mo)
  • Postgres 14+ (included in nSelf stack)

Install the Bundle

nself license set nself_pro_xxxxx  # Your ɳSentry license key
nself plugin install --bundle nsentry

This installs all 13 ɳSentry plugins:

Baseline (7):

  • nself-uptime-monitor
  • nself-status-page
  • nself-incident-mgmt
  • nself-alert-router
  • nself-slo-tracker
  • nself-synthetic-monitor
  • nself-rum

Expansion (6):

  • nself-errors
  • nself-cron-monitor
  • nself-oncall
  • nself-crash
  • nself-anomaly
  • nself-audit (free tier)

Configure

After install, environment variables auto-populate in .env.prod:

# Alert channels
NSENTRY_SLACK_WEBHOOK=https://hooks.slack.com/services/...
NSENTRY_EMAIL_FROM=alerts@yourdomain.com

# SLO targets
NSENTRY_SLO_API_TARGET=99.95
NSENTRY_SLO_WEB_TARGET=99.9

# Retention
NSENTRY_ERROR_RETENTION_DAYS=90
NSENTRY_LOG_RETENTION_DAYS=30

Deploy

nself build
nself start --environment prod

ɳSentry runs on ports 3831–3843 (auto-proxied via Nginx).

First Steps

  1. Access dashboards at sentry.yourdomain.com/dashboards
  2. Configure alert channels (Slack, email, PagerDuty)
  3. Set SLO targets for your critical services
  4. Add synthetic monitors for external endpoints
  5. Enable error tracking in your app SDKs

See Architecture for detailed component overview.