Monitoramento Node.js: ferramentas e bibliotecas para observability

Monitoramento de aplicações JavaScript (Node.js): bibliotecas e ferramentas

No desenvolvimento web moderno, o monitoramento de aplicações Node.js não é apenas uma opção, mas uma necessidade. Sem ele, é impossível garantir estabilidade, desempenho e detecção rápida de erros. Neste artigo, vamos detalhar as principais ferramentas e bibliotecas para construir um sistema de observability (observabilidade) no ecossistema Node.js.

Por que o monitoramento Node.js é necessário?

Node.js é um ambiente single-thread com I/O não bloqueante. Isso significa que um único erro ou vazamento de memória pode paralisar toda a aplicação. O monitoramento ajuda a:

• Rastrear métricas (CPU, memória, número de requisições, tempo de resposta).
• Detectar anomalias (aumento repentino de erros, queda de desempenho).
• Realizar profiling (gargalos no código, vazamentos de memória).
• Configurar alertas (notificações no Slack, Telegram, email).

Principais bibliotecas para monitoramento Node.js

1. Prometheus Client (prom-client)

Este é o exportador padrão de métricas para Node.js, compatível com o popular sistema de coleta de métricas Prometheus. A biblioteca permite criar contadores personalizados, histogramas e métricas sumárias.

const client = require('prom-client');const express = require('express');const app = express();

// Criando um contador de requisiçõesconst httpRequestsTotal = new client.Counter({  name: 'http_requests_total',  help: 'Total number of HTTP requests',  labelNames: ['method', 'route', 'status']});

// Middleware para coleta de métricasapp.use((req, res, next) => {  const start = Date.now();  res.on('finish', () => {    httpRequestsTotal.inc({      method: req.method,      route: req.route?.path || 'unknown',      status: res.statusCode    });  });  next();});

// Endpoint para o Prometheusapp.get('/metrics', async (req, res) => {  res.set('Content-Type', client.register.contentType);  res.end(await client.register.metrics());});

app.listen(3000);

2. OpenTelemetry para Node.js

OpenTelemetry é o padrão moderno para coleta de telemetria (tracing, métricas, logs). Para Node.js, o pacote @opentelemetry/sdk-node está disponível. Ele instrumenta automaticamente bibliotecas populares (Express, HTTP, gRPC) e coleta traces distribuídos.

const { NodeSDK } = require('@opentelemetry/sdk-node');const { ConsoleSpanExporter } = require('@opentelemetry/sdk-trace-node');const { getNodeAutoInstrumentations } = require('@opentelemetry/auto-instrumentations-node');

const sdk = new NodeSDK({  traceExporter: new ConsoleSpanExporter(),  instrumentations: [getNodeAutoInstrumentations()]});

sdk.start();

// Exemplo de tracing automático do Expressconst express = require('express');const app = express();app.get('/', (req, res) => res.send('Hello'));app.listen(3000);

3. PM2 — gerenciador de processos com monitoramento

O PM2 não apenas gerencia a execução de processos Node.js, mas também fornece monitoramento integrado. O comando pm2 monit mostra CPU, memória e número de reinicializações em tempo real. Para monitoramento avançado, use pm2-plus ou pm2-metrics.

// ecosystem.config.jsmodule.exports = {  apps: [{    name: 'my-app',    script: 'app.js',    instances: 2,    exec_mode: 'cluster',    env: {      NODE_ENV: 'production'    }  }]};

4. Clinic.js — profiling e diagnóstico

Clinic.js é um conjunto de ferramentas para análise aprofundada de desempenho do Node.js. Ele inclui Doctor (diagnóstico rápido), Bubbleprof (atrasos assíncronos) e Flame (flamegraph para CPU).

// Instalação: npm install -g clinic// Execução com profiling