Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.
Docs Menu

Guardar entradas de registro personalizadas

Puedes escribir entradas de registro personalizadas desde tus scripts de MongoDB Shell. Las entradas de registro personalizadas ayudan con la depuración, el manejo de errores y te alertan cuando el script realiza funciones específicas.

MongoDB Shell admite los siguientes métodos para entradas de registros personalizadas:

  • log.debug()

  • log.error()

  • log.fatal()

  • log.info()

  • log.warn()

1

El siguiente script inserta documentos en la colección movies y registra una entrada de registro personalizada info. Si el script genera errores, crea una entrada personalizada en el registro error en su lugar.

// connect-and-insert-with-log-entry.js
try {
db = connect( 'mongodb://localhost/myDatabase' );
db.movies.insertMany( [
{
title: 'Titanic',
year: 1997,
genres: [ 'Drama', 'Romance' ]
},
{
title: 'Spirited Away',
year: 2001,
genres: [ 'Animation', 'Adventure', 'Family' ]
},
{
title: 'Casablanca',
genres: [ 'Drama', 'Romance', 'War' ]
}
] )
log.info('InsertData: Inserted 3 movies');
} catch (error) {
log.error('Insert failed', { error: error.message });
}

Guarda el script como connect-and-insert-with-log-entry.js.

2

Para ejecutar el script connect-and-insert-with-log-entry.js, usa mongosh para conectar a tu implementación y ejecuta el siguiente comando dentro de MongoDB Shell:

load("connect-and-insert-with-log-entry.js")

Alternativamente, puedes ejecutar el script programáticamente utilizando la opción --file al iniciar mongosh:

mongosh --file connect-and-insert-with-log-entry.js

La entrada de registro personalizada aparece en los registros de tu sesión:

{"t":{"$date":"2025-02-25T18:04:01.690Z"},"s":"I","c":"MONGOSH-SCRIPTS","id":1000000054,"ctx":"custom-log","msg":"InsertData: Inserted 3 movies"}

Para obtener más información sobre sesiones de registro y cómo recuperar mensajes de registro, consulta Ver registros Shell.

Para verificar que el script insertó los documentos, query la colección movies:

use myDatabase
db.movies.find()

Salida:

[
{
_id: ObjectId('67bde8c2a527c6b1341979f2'),
title: 'Titanic',
year: 1997,
genres: [ 'Drama', 'Romance' ]
},
{
_id: ObjectId('67bde8c2a527c6b1341979f3'),
title: 'Spirited Away',
year: 2001,
genres: [ 'Animation', 'Adventure', 'Family' ]
},
{
_id: ObjectId('67bde8c2a527c6b1341979f4'),
title: 'Casablanca',
genres: [ 'Drama', 'Romance', 'War' ]
}
]