La telemetría de uso del producto recoge metadatos estructurados de configuración y salud de tu instalación de Ops Manager y de los despliegues que gestiona. Envía esos datos a MongoDB. Ops Manager habilita por defecto la telemetría de uso del producto.
A partir de Ops Manager 9.0.2 y 8.0.28, la telemetría de uso del producto reemplaza la telemetría utilizada en Ops Manager 8.0.27 y anteriores. La telemetría de uso del producto recopila metadatos de configuración y salud sobre tu instalación de Ops Manager y los despliegues que gestiona. MongoDB vincula los datos a tu cuenta Enterprise Advanced. Ops Manager 8.0.27 y anteriormente recopilaron un informe anónimo que no pudo identificar ni a ti ni a tu organización. Para más detalles, véase Telemetría en Ops Manager 8.0.27 y anteriores.
Sobre la telemetría de uso del producto
La telemetría de uso del producto describe cómo están configurados tu instalación de Ops Manager y los despliegues que gestiona. Cubre versiones, topología, recursos provisionados, configuraciones de copia de seguridad, ajustes TLS y métodos de autenticación.
Datos recogidos y excluidos
La telemetría de uso del producto incluye los IDs de tus organizaciones, proyectos y despliegues de Ops Manager. También incluye los nombres de tus conjuntos y fragmentos de réplica. Para la lista completa de campos, véase Recuperar datos de telemetría.
La telemetría de uso del producto no incluye contenido de bases de datos o documentos, información de consultas, registros de aplicaciones, secretos o credenciales.
La telemetría de uso del producto permite a MongoDB vincular la información recopilada a tu cuenta Enterprise Advanced. Para ello, Ops Manager firma cada carga útil con una clave de25519 Ed única para tu instalación a través de su componente de licencia. MongoDB verifica la firma y utiliza tu inscripción de licencia para asociar la telemetría con tu cuenta. Si MongoDB no puede verificar la firma, sigue aceptando la telemetría pero no la asocia con tu cuenta.
Frecuencia y retención
La siguiente tabla describe con qué frecuencia Ops Manager recoge y envía telemetría de uso del producto, y cuánto tiempo MongoDB la conserva.
Item | Comportamiento |
|---|---|
Cadencia | Ops Manager recoge una instantánea una vez al día y envía la telemetría de uso del producto a MongoDB una vez por semana. Cada semana, Ops Manager envía las instantáneas diarias de los siete días anteriores. Cada instantánea viaja como su propia carga útil. Ops Manager mantiene cada instantánea en su AppDB durante 90 días después de recogerla y luego la elimina. |
Primera colección | En un plazo de seis horas después de instalar o actualizar a Ops Manager 9.0.2, 8.0.28, o más tarde. Ops Manager envía la primera carga útil seis días después de la primera recopilación. |
Repeticiones | Si falla un envío, Ops Manager mantiene la instantánea y lo intenta cada seis horas hasta que el envío tenga éxito. Ops Manager sigue funcionando normalmente mientras intenta reiniciar. Si Ops Manager no puede contactar con MongoDB, conserva las instantáneas diarias de los últimos 90 días y elimina las anteriores. Si no se envía nada durante 8 días, aparece un banner en las páginas de Despliegue. Para resolverlo, consulta Solucionar problemas de Telemetría de Uso del Producto. |
Retención en MongoDB | MongoDB mantiene la telemetría de uso del producto durante 90 días, comenzando cuando MongoDB la recibe. Una instantánea diaria individual puede conservarse hasta 97 días, tras lo cual MongoDB la elimina automáticamente. |
Ubicación | MongoDB almacena la telemetría de uso de productos en la región |
Exención de telemetría
La telemetría de uso del producto está activada por defecto. Solo puedes desactivarla si la clave de licencia instalada incluye una exención activa de telemetría. Esto se aplica a todos los estados de licencia, incluyendo Expirado y Sin Licencia. Para solicitar una exención, contacta con el equipo de tu cuenta de MongoDB.
Si la clave de licencia incluye una exención activa de telemetría, la página del Gestor de Claves de Licencia muestra el derecho Telemetry Exemption bajo Entitlements. Para abrir la página, haga clic Admin, License Keys. El derecho dice:
"Una excepción aprobada, incluida en tu clave de licencia, que te da la opción de desactivar la telemetría de uso del producto en el Administrador de Operaciones. Esta excepción fue solicitada por tu equipo de cuenta."
Una exención de telemetría solo está activa durante su periodo de validez. El periodo de validez está definido en la clave de licencia y no puede extenderse más allá de la concesión de la clave de licencia que la incluye.
Cuando termina el periodo de validez, el interruptor de Product Telemetry Collection se vuelve a bloquear. La telemetría de uso del producto se vuelve obligatoria. Para mantenerla desactivada, solicita una nueva exención al equipo de tu cuenta de MongoDB e instala una clave de licencia que la incluya.
Las versiones anteriores de Ops Manager usan una configuración de telemetría separada. Desactivar la telemetría en una versión anterior no desactiva la telemetría de uso del producto después de actualizar.
Para más información sobre claves de licencia y derechos, consulte Resumen de las Claves de Licencia del Gestor de Operaciones.
La siguiente tabla describe cómo se comporta el interruptor de Product Telemetry Collection en cada situación.
Situación | Alternar | Telemetría de uso del producto |
|---|---|---|
No hay exención de telemetría activa | Encendido y bloqueado | La recogida continúa y los datos se suben en el calendario habitual. |
Se instala una clave de licencia con una exención activa de telemetría | Desbloqueado. Se queda encendido hasta que lo apagas. Instalar la llave de licencia no desactiva la telemetría | Si está activado, la colección y las subidas continúan hasta que lo apagas. |
Tienes una clave de licencia con una exención de telemetría activa y desactiva el interruptor | Apagado | No recogido ni enviado. |
Tienes una clave de licencia con una exención de telemetría activa y vuelves a activar el interruptor | on | Ops Manager recoge una instantánea en su siguiente comprobación, en un plazo de seis horas, y reanuda el envío. |
El periodo de validez de la exención finaliza | Encendido y bloqueado de nuevo, aunque la clave de licencia siga instalada | La recogida vuelve a ser obligatoria. Las subidas siguen el calendario habitual. |
Más adelante se vuelve a instalar una clave de licencia con una exención activa | Desbloqueado y vuelve a la última opción que guardaste | Sigue el interruptor |
Ver Configuración de Telemetría de Uso del Producto
Para ver la configuración de telemetría de uso del producto, debes tener el rolGlobal Owner.
La siguiente tabla describe los elementos en la pestaña de Telemetría.
Elemento UI | Descripción |
|---|---|
Product Telemetry Collection toggle | Activa o desactiva la telemetría de uso del producto. Para más detalles, véase Exención de Telemetría. |
Learn more | Se abre la página de visión general de telemetría sobre el uso del producto. |
Next Scheduled Upload | Cuando el Gestor de Operaciones envíe la telemetría de uso del producto a MongoDB. En blanco cuando la telemetría esté desactivada y antes de la primera recopilación. |
Last Successful Upload | Cuando el Gerente de Operaciones entregó por última vez la telemetría de uso del producto a MongoDB. En blanco hasta el primer envío exitoso. |
Current Collected Data: Download | Recoge datos frescos y los descarga como |
View data details | Abre un resumen de la configuración de telemetría de uso del producto y las categorías de datos que recopila. |
Nota
Durante la configuración inicial, el asistente de configuración muestra que la telemetría de uso del producto está activada por defecto, sin necesidad de alternar. Tras la configuración, puedes revisar los datos en la pestaña de Telemetría.
Ver los datos antes de que el administrador de operaciones los envíe
Cada vez que descargas los datos, Ops Manager los recoge y devuelve el informe actual. La descarga no devuelve una instantánea almacenada.
Revisa el archivo descargado
Abrir telemetry-data.json. Para una descripción de su contenido, véase Datos recopilados.
También puedes llamar al endpoint Retrieve Telemetry Data . Su campo data contiene el mismo contenido que el archivo descargado.
Desactivar la telemetría de uso del producto
Para desactivar la telemetría de uso del producto, necesitas:
El
Global Ownerpapel.Una exención activa de telemetría en la clave de licencia instalada.
Utiliza la interfaz de usuario
Puedes desactivar la telemetría de uso del producto desde la interfaz de Ops Manager.
Usar la API
También puedes desactivar la telemetría de uso del producto llamando al endpoint Toggle Telemetry Status con { "enabled": false }.
Cuando la telemetría de uso del producto está desactivada, el Gestor de Operaciones deja de recogerla y enviarla. Next Scheduled Upload queda en blanco y Last Successful Upload mantiene su valor.
Telemetría del producto no enviada banner
Si Ops Manager no puede enviar telemetría de uso de producto, muestra un banner de advertencia en las páginas de Despliegue. Cada usuario que puede abrir la página de Despliegue ve el banner en todas las pestañas, y no puedes descartarlo. El banner aparece cuando la clave de licencia no tiene exención activa de telemetría y han pasado 8 o más días desde el último envío exitoso. Borra cuando un envío tiene éxito o cuando instalas una clave de licencia con una exención activa de telemetría.
Para resolver el banner, consulte Solucionar problemas de Telemetría de Uso del Producto.
Requisitos de red
Cada host de Ops Manager debe tener acceso HTTPS saliente en el 443 de puerto TCP y resolución DNS para cloud.mongodb.com.
Cómo se asegura la telemetría de uso del producto
La siguiente tabla describe los controles que protegen la telemetría de uso del producto.
Área | Control |
|---|---|
En tránsito | Ops Manager envía telemetría a través de HTTPS (TLS 12 o posterior). |
Autenticidad | A través de su componente de licencia, Ops Manager firma cada carga útil con una clave de25519 Ed única para tu instalación. MongoDB verifica la firma cuando recibe la carga útil. Si no hay firmas disponibles, Ops Manager envía el informe sin firmar. |
En reposo | MongoDB cifra los datos en AWS con claves gestionadas por KMS. |
Control de acceso | Los roles de IAM de menor privilegio en la zona de aterrizaje S3 restringen el acceso al personal designado de ingeniería de MongoDB. |
Auditoría | El registro exhaustivo de auditorías rastrea todas las solicitudes de acceso y operaciones de datos |
Datos recopilados
Cada carga útil que envía Ops Manager tiene tres partes.
Parte | Descripción |
|---|---|
Carga útil | Un sobre a prueba de manipulación creado por tu instalación de Ops Manager en el momento de enviar. Contiene una huella digital (SHA-256 digest) del informe y identificadores que vinculan el informe con la inscripción en tu Ops Manager. No contiene el informe en sí, que se distribuye en Métricas. |
Firma | Una firma digital sobre el sobre, creada con la clave Ed25519 de tu instalación. La firma demuestra que el informe proviene de la instalación de tu Ops Manager y no ha cambiado durante el tránsito. |
Métricas | El propio informe, en JSON simple |
El archivo telemetry-data.json descargado y la API solo devuelven el informe. Para la lista completa de campos, tipos y ejemplos, consulte Recuperar datos de telemetría.
Ejemplo de carga útil
Ops Manager envía cada instantánea a MongoDB con una huella y firma de la carga útil sobre el informe. MongoDB utiliza los campos payload y signature para verificar el informe. El campo metrics es el propio informe, en JSON simple. La descarga y la API devuelven el mismo informe:
{ "payload": "eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCJ9.eyJ...", "signature": "MEUCIQDx8fJ2kQ7vL3mN5pR9sT1uW3yA5bC7dE9fG1hI3jK5wQI...", "metrics": { "data": { "appDbNodes": 3, "backupDaemons": 1, "deployments": [ ... ], "infrastructure": "VM", "instances": [ ... ], "omAuthMethod": "LDAP", "orgs": 1, "projects": 2, "uuid": "3f8a2c6e-9b1d-4e7a-a5c3-8d2f1b6e4a90", "version": "9.0.2" }, "generationTimestamp": 1794442020000, "ingestionTimestamp": 1794442020000 }}Para un ejemplo completo de respuesta, véase Recuperar datos de telemetría.
Cabeceras de petición HTTP
La infraestructura de MongoDB también registra un pequeño conjunto de cabeceras estándar de solicitud HTTP de cada solicitud HTTPS que envía tu instalación de Ops Manager. MongoDB utiliza estas cabeceras únicamente para la integridad operativa: verificación de entrega, resolución de problemas y prevención de abusos. MongoDB no almacena estas cabeceras con la telemetría de uso del producto.
Encabezado | Descripción | Ejemplo |
|---|---|---|
User-Agent | Identifica la biblioteca cliente HTTP que envió la solicitud | Apache-HttpClient/5.5 (Java/21) |
host | El nombre de host del endpoint de telemetría al que se envía la solicitud | cloud.mongodb.com |
Content-Type | El tipo de medios del organismo de solicitud | application/json |
Duración del contenido | El tamaño del cuerpo de la solicitud en bytes | 2847 |
Codificación de contenido | La codificación de transferencia aplicada al cuerpo | gzip |
X-Forwarded-For / dirección de origen | La dirección IP pública Ops Manager se conecta desde | 203.0.113.42 |
Nota
MongoDB conserva las cabeceras de las solicitudes HTTP en los registros de peticiones durante 390 días, tras lo cual las elimina.