Selfhosted version of Nestjs Observe

Jorge Montejo — Fri, 30 Oct 2026 07:34:34 +0000

The problem

If you use @nestjs/observe to monitor your NestJS apps, your telemetry (requests, errors, logs, traces) lives in an external service with plan limits. I wanted the same experience, but running on my own infrastructure.

So I built selfhosted-nestjs-observe: a self-hosted collector and dashboard that works with the @nestjs/observe agent.

What's inside

Drop-in collector: you only change the agent's endpoint. Nothing else in your code changes.

Up and running in a minute

The image is published to GHCR (amd64 and arm64):

mkdir observe && cd observe
curl -fsSLO https://raw.githubusercontent.com/MontejoJorge/selfhosted-nestjs-observe/main/deploy/docker-compose.yml
curl -fsSL -o .env https://raw.githubusercontent.com/MontejoJorge/selfhosted-nestjs-observe/main/deploy/.env.example
# set POSTGRES_PASSWORD in .env
docker compose up -d

Open http://localhost:3000, create a project and an application, and copy the API key (the secret is shown only once).

Connect your NestJS app

export const { ObserveModule, ObserveInstrument } = createObserveModule();

@Module({
  imports: [
    ObserveModule.forRoot({
      endpoint: process.env.OBSERVE_ENDPOINT, // your collector
      appKey: process.env.OBSERVE_APP_KEY,
      appSecret: process.env.OBSERVE_APP_SECRET,
      serviceId: 'orders-api',
      forwardLogs: true,
    }),
  ],
})
export class AppModule {}

👉 GitHub: https://github.com/MontejoJorge/selfhosted-nestjs-observe

DEV Community: Jorge Montejo

Selfhosted version of Nestjs Observe

The problem

What's inside

Up and running in a minute

Connect your NestJS app