Mongoose

autotel-mongoose instruments Mongoose 8+ with stable semantic conventions, query text capture, and default PII redaction.

Installation

npm install autotel autotel-mongoose mongoose

Basic Usage

import mongoose from 'mongoose';
import { init } from 'autotel';
import { instrumentMongoose } from 'autotel-mongoose';

init({ service: 'my-app', endpoint: 'http://localhost:4318' });

instrumentMongoose(mongoose, { dbName: 'myapp' });

const User = mongoose.model(
  'User',
  new mongoose.Schema({ name: String, email: String }),
);

await User.findOne({ email: 'alice@example.com' }).exec();
// Span: "find users" with db.query.text (PII redacted)

Hook Instrumentation

instrumentMongoose(mongoose, { instrumentHooks: true });

userSchema.pre('save', async function () {
  this.set('name', this.get('name')?.trim());
  // Pre/post hooks get their own spans
});

Configuration

Option	Default	Description
dbName	—	Database name
peerName	—	MongoDB host
peerPort	—	MongoDB port
captureCollectionName	true	Include collection in span
instrumentHooks	false	Wrap pre/post hooks
dbStatementSerializer	built-in	Custom query serializer
statementRedactor	'default'	PII redaction preset

Examples

• example-mongoose: Mongoose with query text capture, PII redaction, and hook instrumentation.

Semantic Conventions

Uses stable OTel conventions only:

• db.system.name
• db.operation.name
• db.collection.name
• db.namespace
• db.query.text
• server.address / server.port