Documentation

DbPulse gives you real-time visibility into every database query hitting your APIs. Track performance, identify bottlenecks, and monitor your databases effortlessly.

MongoDB active PostgreSQL coming soon MySQL coming soon

๐Ÿƒ MongoDB โ— Active

Setup

Follow these steps to start tracking MongoDB queries in your Node.js application.

  1. Download the DbPulse desktop app for your platform.Get it here
  2. Sign up and add your MongoDB connection string. You'll receive an apiKey and connectionId.
  3. Install the agent in your project:
    npm install dbpulse-agent
  4. Initialize the agent with your credentials (see the full example below).
  5. Add middleware to your Express app (see the full example below).

That's it โ€” DbPulse will now capture every MongoDB query with API context and execution time. Logs are retained for 7 days.

Full Implementation

Current support: The agent is available for Node.js applications using MongoDB.

Add the following code to your main server file (e.g., app.js or index.ts):

import { DBPulseAgent } from "dbpulse-agent";

DBPulseAgent.init({
  apiKey: "your-api-key",
  connectionId: "your-connection-id",
  debug: false,
});

import express from "express";
const app = express();
app.use(DBPulseAgent.trackRequests());

Note: The agent automatically detects your MongoDB driver and only tracks queries when a connection is active.

Tracking features

  • Every find, insert, update, delete and aggregation
  • Execution time (ms) per query
  • Correlated with the API endpoint that triggered it
  • Filterable logs by database, collection, and time range

Example log entry

As displayed in the desktop app:

14:23:45MDBPRODGETusers12ms192.168.1.1
โšก Method: GET
๐Ÿ“ Collection: users
๐Ÿ“ Route: /api/users
{
  "filter": { "status": "active" },
  "projection": { "name": 1, "email": 1 }
}

Each log row shows timestamp, database type, environment, HTTP method, collection/table, query preview, duration, and client IP. Click to expand for full query details.

๐Ÿ˜ PostgreSQL โ— Coming soon

PostgreSQL support is in active development. Expected release: Q2 2026.

๐Ÿšง We're working on full integration with pg driver and connection pooling.

  • Planned: query parsing, parameterized queries, and execution plans
  • Will support all major PostgreSQL versions (12+)

๐Ÿฌ MySQL โ— Coming soon

MySQL support is planned after PostgreSQL. Expected release: Q3 2026.

๐Ÿ“‹ We'll support both mysql2 and native mysql packages.