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

Exportar registros a servicios externos

Importante

La función descrita en esta página no es compatible actualmente con los clústeres de Atlas Infinite durante la versión preliminar pública. Para conocer las funciones compatibles con la versión preliminar pública, consulte Disponibilidad de la versión preliminar pública.

Puedes configurar tus clústeres de M10+ Atlas para exportar registros del sistema cada minuto a un servicio externo. Exportar registros a un servicio externo permite una gestión centralizada de registros, conservación a largo plazo e integración con sus actuales herramientas de supervisión y observabilidad.

Atlas es compatible con la exportación de los siguientes tipos de registros:

Puedes especificar qué tipos de registros deseas exportar y configurar hasta 10 rutas de exportación para enviar registros a varios destinos simultáneamente.

Importante

Los registros pueden contener información sensible (incluida la PII). Usted es responsable del almacenamiento y tratamiento de sus registros en su servicio externo. Para que Atlas redacte cierta información antes de exportar registros, ponerse en contacto con Soporte de MongoDB.

  • Para exportar registros, debe tener un clúster M10+. La exportación de registros no está disponible para clústeres gratuitos o de nivel compartido. Este requisito no se aplica a la exportación de eventos de Activity Feed, que admite clústeres de todos los niveles.

  • Debe tener acceso a Project Owner o Organization Owner para configurar la exportación de registros.

  • Cada host de Atlas generalmente produce 1 GB de registros por día. Exportar registros implica un costo de transferencia de datos. El costo exacto de la transferencia de datos varía según el destino, la región y el proveedor de nube.

  • La salida de registros se origina en el plano de control de Atlas en AWS us-east-1, independientemente de la región o el proveedor de nube de su clúster. Si su clúster no se encuentra en AWS us-east-1, se le cobrarán cargos por transferencia de datos entre regiones o entre nubes, además de los costos de salida de Internet. Para obtener más información sobre los costos de transferencia de datos, consulte Costos de transferencia de datos.

  • Los problemas de red o los reintentos pueden causar registros duplicados en su servicio externo.

Atlas gestiona automáticamente los errores de exportación de registros y se recupera sin intervención manual:

Cuando falla la entrega de registros a su receptor externo, Atlas reintenta automáticamente con retroceso exponencial hasta 3 intentos por defecto. El retraso de reintento comienza en 1 segundo y se duplica hasta un máximo de 10 segundos entre intentos.

Después de 5 fallos consecutivos, un disyuntor se abre para evitar sobrecargar su receptor con solicitudes repetidas. El disyuntor permanece abierto durante 5 minutos antes de intentar un guardar de prueba. Si la prueba tiene éxito, se reanuda la operación normal. Si falla, el disyuntor se vuelve a abrir.

Cada configuración de receptor tiene su propio disyuntor independiente, por lo que los problemas con una integración no afectan a otras.

Cuando se agotan los reintentos o los errores no se pueden volver a intentar (como credenciales no válidas), Atlas pone en cola los eventos de registro fallidos en una cola de mensajes no entregados (DLQ) con una retención de 0 7días. La DLQ evita la pérdida de datos mientras el receptor no está disponible.

Advertencia

Los registros de más de 7 días se eliminan permanentemente de la DLQ. Si el receptor permanece inaccesible durante más de 7 días, esos registros no se podrán recuperar.

Cuando se restaura la conectividad y el disyuntor se cierra, Atlas reproduce automáticamente los registros en cola desde la DLQ a su receptor. No se requiere intervención manual.

Advertencia

Si modifica la configuración del receptor mientras los registros están en cola en la DLQ, los registros en cola utilizarán la nueva configuración cuando se reproduzcan. Por ejemplo, si cambia el destino de un bucket S3 a otro, los registros en cola se enviarán al nuevo bucket en lugar del destino original.

Atlas proporciona alertas por defecto que envían automáticamente notificaciones por correo electrónico a los usuarios de Project Owner cuando:

  • Exportación de registros encuentra errores no reintentables (registros en cola en DLQ).

  • La exportación de registros falla después de varios intentos (los registros se encuentran en la cola de mensajes no entregados).

  • La reproducción de la exportación de registro no logra entregar los registros.

Estas alertas son informativas, lo que significa que solo aparecen en la fuente de actividad del proyecto y no aparecen en las pestañas Open Alerts o Closed Alerts de la página Project Alerts. Para obtener más información sobre el ciclo de vida de las alertas informativas, consulte flujo de trabajo de alertas.

Además, la fuente de actividad del Proyecto registra los siguientes eventos informativos:

  • Exportación de registros recuperada (registros en cola listos para reanudarse).

  • Exportación de registros recuperada (los registros en cola se están enviando ahora).

  • Todos los registros en cola han sido entregados.

Puedes personalizar los destinatarios de las alertas y los métodos de notificación en la configuración de alertas de tu proyecto. Para obtener más información, consulta Configurar una alerta.

La siguiente tabla resume los servicios externos que Atlas admite para la exportación de registros:

Destino
Descripción

Exporta los registros mongod, mongos y de auditoría a un bucket S3 de AWS. Admite puntos de acceso multirregionales (MRAP).

Exporta mongod, mongos y los registros de auditoría a un contenedor de Azure Blob Storage.

Exporta mongod, mongos y los registros de auditoría a Datadog para el análisis de registros en tiempo real y tableros.

Exporta mongod, mongos y registros de auditoría a un bucket de Google Cloud Storage.

Exporta mongod, mongos y registros de auditoría a un endpoint de OpenTelemetry (OTel) para observabilidad neutral de proveedores.

Exporta mongod, mongos y registros de auditoría a Splunk Cloud o Splunk Enterprise para la búsqueda y el análisis centralizados de registros.

Todos los destinos compatibles pueden exportar eventos de Activity Feed a nivel de proyecto. La exportación de eventos a nivel de organización solo admite OpenTelemetry.