Documentation

Getting Started

Introduction

Monocle is an observability platform for Node.js applications, built on OpenTelemetry

Monocle shows you what your application is doing in production: every request, query, job, log line, and exception, connected in a single timeline. Install the agent, deploy, and the dashboards fill in on their own.

Get started

What you get out of the box

As soon as the agent runs, Monocle collects:

  • Traces for every request, job, and command, with the full span waterfall across your services
  • Issues: exceptions grouped by root cause, with stack traces, source code context, and the users they affected
  • Logs linked to the trace that produced them
  • Requests: throughput, error rate, and P95 latency of every endpoint
  • Database queries: slow and failing queries, grouped by pattern
  • External calls to third-party APIs
  • Users: who hit an error or a slow page
  • System metrics: CPU, memory, heap, and event loop
  • Emails and commands for AdonisJS apps
Monocle project overview

Dedicated dashboards

Some workloads get their own dashboard once their instrumentation is enabled:

Built on OpenTelemetry

Your telemetry stays portable. Monocle uses standard OpenTelemetry protocols, so you can send the same data to Grafana, Honeycomb, or any OTLP-compatible backend alongside Monocle, and send data to Monocle from any OpenTelemetry SDK.

Search documentation

Search pages and sections of the Monocle documentation