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.

Retrieve Telemetry Data

Recupere el estado de la recopilación de telemetría y los detalles de configuración para su instalación de Ops Manager.

Importante

Comenzando en Ops Manager 9.0.2 y 8.0.28, este endpoint devuelve la telemetría de uso del producto, que utiliza una estructura de respuesta diferente. Para la respuesta más reciente, véase Respuesta de Telemetría de Uso del Producto.

Este punto terminal requiere una clave API que tenga el rol Global Owner.

URL base: https://{OPSMANAGER-HOST}:{PORT}/api/private/v1.0/telemetry

GET /collection/details

Este endpoint no utiliza parámetros de ruta de solicitud HTTP.

Este punto final no utiliza parámetros de query de solicitudes HTTP.

Este endpoint no utiliza parámetros de cuerpo de solicitud HTTP.

El documento JSON de respuesta incluye los siguientes campos:

Nombre
Tipo
Descripción

habilitado

booleano

Indica que el sistema recoge y envía telemetría de uso del producto.

último_envio_exitoso

datetime

Fecha y hora del último envío exitoso de telemetría.

next_job

datetime

Fecha y hora en la que está programado el próximo envío de telemetría.

Datos

Objeto

Objeto que contiene los campos definidos en la Respuesta de Telemetría de Uso del Producto.

A partir de Ops Manager 9.0.2 y 8.0.28, este endpoint devuelve la telemetría de uso del producto. El documento JSON de respuesta incluye los siguientes campos:

Nombre
Tipo
Descripción

habilitado

booleano

Si la telemetría de uso del producto está activada. Siempre true a menos que la clave de licencia tenga una exención activa de telemetría. Con una exención, el valor refleja la configuración de Product Telemetry Collection toggle.

último_envio_exitoso

cadena (ISO 8601, UTC) o nula

Cuando Ops Manager entregó por última vez el uso del producto, telemetría. null si nunca ha sido así.

next_job

cadena (ISO 8601, UTC) o nula

Cuando vence el próximo envío semanal. null antes de la primera recogida y mientras la telemetría está desactivada.

Datos

Objeto

El informe de uso del producto que el Administrador de Operaciones recopila cuando haces la solicitud. Contiene generationTimestamp, ingestionTimestamp, y un objeto data anidado, que describen las tablas siguientes.

El objeto data anidado incluye los siguientes campos sobre la instalación de Ops Manager:

Campo
Tipo
Descripción
Ejemplo

uuid

string

Identificador estático para tu instalación de Ops Manager

3f8a2c6e-9b1d-4e7a-a5c3-8d2f1b6e4a90

version

string

¿Qué versión de Ops Manager ejecuta la instalación

9.0.2

instances

Arreglo de objetos

Para cada host de Ops Manager: memoria provisionada en bytes, núcleos de CPU y sistema operativo

68719476736, 16, Linux 5.14.0-427.el9.x86_64 amd64

omAuthMethod

string

Cómo se autentican los usuarios en Ops Manager

LDAP

appDbNodes

entero

El número de nodos en la AppDB del Administrador de Operaciones

3

backupDaemons

entero

El número de Demonios de Reserva configurados

1

infrastructure

string

El tipo de infraestructura que aloja Ops Manager

VM

orgs

entero

Número de organizaciones en la instalación

1

projects

entero

Número de proyectos en la instalación

2

generationTimestamp

entero

Cuando Ops Manager generó la instantánea diaria, en milisegundos desde la época de Unix

1794442020000

ingestionTimestamp

entero

Cuando Ops Manager envió la instantánea, en milisegundos desde la época Unix. En la descarga y la API, equivale al tiempo de la instantánea

1794442020000

appDbLastRestoreTime

entero

Cuando Ops Manager detectó una restauración de su AppDB, en milisegundos desde la época Unix

1794441600000

Cada elemento del deployments array incluye los siguientes campos:

Campo
Tipo
Descripción
Ejemplo

deploymentId

string

El ID de clúster de 24caracteres que Ops Manager asigna cuando se crea el despliegue por primera vez. Para un despliegue independiente, el ID es un hash de 32caracteres del identificador de host

664f1c2b8e3a4d0012ab34ef

type

string

Uno de: RS (conjunto réplica), SC (clúster fragmentado), independiente o búsqueda (mongot)

RS

orgId

string

El ID de 24caracteres de la organización a la que pertenece el despliegue

664f1c1a8e3a4d0012ab3401

projectId

string

El ID de 24carácter del proyecto al que pertenece el despliegue

664f1c2b8e3a4d0012ab34cd

tlsEnabled

booleano

Si el despliegue utiliza TLS

true

clusterAuthMethod

string

Cómo se autentica Ops Manager en el despliegue. Uno de: MONGODB-CR (nombre de usuario y contraseña, incluyendo SCRAM), GSSAPI (Kerberos), PLAIN (LDAP), MONGODB-X509o MONGODB-OIDC

MONGODB-CR

irgEnabledTime

entero o null

Si compraste soporte de 30minutos de respuesta inicial, cuando se habilitó para el despliegue, en milisegundos desde la época Unix. Vacío si no.

1790847000000

Cada elemento del nodes array incluye los siguientes campos:

Campo
Tipo
Descripción
Ejemplo

hostId

string

Un hash del ID del proyecto y del nombre de host y puerto del nodo. El nombre de host en sí no se envía

db5a69d233913ff685a5087b0b760671

type

string

Uno de: MONGOD (nodo de base de datos), MONGOS (router de clúster fragmentado) o MONGOT (nodo de búsqueda)

MONGOD

version

string

La versión de MongoDB el nodo se ejecuta

8.0.12

cpu

entero

Los núcleos de CPU provisionados por el nodo

8

memoryBytes

entero

La memoria provisionada del nodo, en bytes

34359738368

storageBytes

entero o null

El almacenamiento provisionado del nodo, en bytes

214748364800

isEnterprise

Booleano o nulo

Si el binario del nodo incluye el módulo empresarial. Vacío para MONGOT

true

rsId

string o nula

El nombre del conjunto réplica del nodo, como lo llamaste

RS0

replicaType

string o nula

Uno de: PRIMARIO, SECUNDARIO o ÁRBITRO

Primario

shardId

string o nula

El nombre del fragmento del nodo, como lo llamaste. Solo clústeres fragmentados

fragmento01

Si el despliegue tiene configurada una copia de seguridad, el objeto backupConfig incluye los siguientes campos:

Campo
Tipo
Descripción
Ejemplo

status

string

Estado de la configuración de respaldo del despliegue. Uno de:

  • INACTIVE: Nunca se ha activado el refuerzo.

  • PROVISIONING: Se está provisionando la copia de seguridad y aún no ha comenzado.

  • STARTED: El respaldo está activado y en marcha.

  • STOPPED: La copia de seguridad se activó y luego se detuvo. Las instantáneas existentes siguen disponibles para restauración.

  • TERMINATING: La terminación de la copia de seguridad está en curso.

INICIADO

snapshotScheduleIntervalMinutes

entero

Con qué frecuencia se toman las instantáneas, en minutos

360

snapshotStoreType

string

Uno de: BS (blockstore), FS (sistema de archivos), S3 (AWS S3 bucket), 3PSS (de terceros) o MRTS (multirregión temporal)

BS

curl --user "{publicApiKey}:{privateApiKey}" --digest \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --include \ --request GET "https://<OpsManagerHost>:<Port>/api/private/v1.0/telemetry/collection/details"
{ "data": { "data": { "appDbNodes": 3, "backupDaemons": 1, "deployments": [ { "backupConfig": { "snapshotScheduleIntervalMinutes": 360, "snapshotStoreType": "FS", "status": "STARTED" }, "clusterAuthMethod": "SCRAM-SHA-256", "deploymentId": "6720b1c2d3e4f5a6b7c8d9e0", "irgEnabledTime": 1792056600000, "nodes": [ { "cpu": 8, "hostId": "3a203aad42cb0c248a606433a2d1e162", "isEnterprise": true, "memoryBytes": 34359738368, "replicaType": "PRIMARY", "rsId": "rs0", "shardId": null, "storageBytes": 536870912000, "type": "MONGOD", "version": "8.0.12" }, { "cpu": 8, "hostId": "2026cb4d8ffc69d2836815a5db3f0b7e", "isEnterprise": true, "memoryBytes": 34359738368, "replicaType": "SECONDARY", "rsId": "rs0", "shardId": null, "storageBytes": 536870912000, "type": "MONGOD", "version": "8.0.12" } ], "orgId": "6710a2b3c4d5e6f7a8b9c0d1", "projectId": "6710a2b3c4d5e6f7a8b9c0d2", "tlsEnabled": true, "type": "RS" }, { "backupConfig": null, "clusterAuthMethod": "MONGODB-X509", "deploymentId": "6720b1c2d3e4f5a6b7c8d9e1", "irgEnabledTime": null, "nodes": [ { "cpu": 16, "hostId": "b913467c9fc3426778a02a9d66f08162", "isEnterprise": true, "memoryBytes": 68719476736, "replicaType": "PRIMARY", "rsId": "shard01", "shardId": "shard01", "storageBytes": 1073741824000, "type": "MONGOD", "version": "8.0.12" }, { "cpu": 4, "hostId": "9259f6ae730e17f5031166eeab0f80e9", "isEnterprise": true, "memoryBytes": 8589934592, "replicaType": null, "rsId": null, "shardId": null, "storageBytes": null, "type": "MONGOS", "version": "8.0.12" } ], "orgId": "6710a2b3c4d5e6f7a8b9c0d1", "projectId": "6710a2b3c4d5e6f7a8b9c0d3", "tlsEnabled": true, "type": "SC" } ], "infrastructure": "VM", "instances": [ { "cpu": 16, "memoryBytes": 68719476736, "os": "Linux 5.14.0-427.13.1.el9_4.x86_64 amd64" } ], "omAuthMethod": "LDAP", "orgs": 1, "projects": 2, "uuid": "3f6c2a9e-8b41-4d7e-9a52-1c0e7b4d2f68", "version": "9.0.2" }, "generationTimestamp": 1793664420000, "ingestionTimestamp": 1793664420000 }, "enabled": true, "last_successful_send": "2026-10-28T00:07:14Z", "next_job": "2026-11-04T00:07:14Z"}