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.
Roles necesarios
Este punto terminal requiere una clave API que tenga el rol Global Owner.
Endpoint
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/private/v1.0/telemetry
GET /collection/detailsSolicitud
Parámetros de ruta
Este endpoint no utiliza parámetros de ruta de solicitud HTTP.
Parámetros de query
Este punto final no utiliza parámetros de query de solicitudes HTTP.
Parámetros del cuerpo
Este endpoint no utiliza parámetros de cuerpo de solicitud HTTP.
Respuesta
Documento de respuesta
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. |
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 |
último_envio_exitoso | cadena (ISO 8601, UTC) o nula | Cuando Ops Manager entregó por última vez el uso del producto, telemetría. |
next_job | cadena (ISO 8601, UTC) o nula | Cuando vence el próximo envío semanal. |
Datos | Objeto | El informe de uso del producto que el Administrador de Operaciones recopila cuando haces la solicitud. Contiene |
Campos a nivel de instalación
El objeto data anidado incluye los siguientes campos sobre la instalación de Ops Manager:
Campo | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| string | Identificador estático para tu instalación de Ops Manager | 3f8a2c6e-9b1d-4e7a-a5c3-8d2f1b6e4a90 |
| string | ¿Qué versión de Ops Manager ejecuta la instalación | 9.0.2 |
| 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 |
| string | Cómo se autentican los usuarios en Ops Manager | LDAP |
| entero | El número de nodos en la AppDB del Administrador de Operaciones | 3 |
| entero | El número de Demonios de Reserva configurados | 1 |
| string | El tipo de infraestructura que aloja Ops Manager | VM |
| entero | Número de organizaciones en la instalación | 1 |
| entero | Número de proyectos en la instalación | 2 |
| entero | Cuando Ops Manager generó la instantánea diaria, en milisegundos desde la época de Unix | 1794442020000 |
| 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 |
| entero | Cuando Ops Manager detectó una restauración de su AppDB, en milisegundos desde la época Unix | 1794441600000 |
Campos a nivel de despliegue
Cada elemento del deployments array incluye los siguientes campos:
Campo | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| 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 |
| string | Uno de: RS (conjunto réplica), SC (clúster fragmentado), independiente o búsqueda ( | RS |
| string | El ID de 24caracteres de la organización a la que pertenece el despliegue | 664f1c1a8e3a4d0012ab3401 |
| string | El ID de 24carácter del proyecto al que pertenece el despliegue | 664f1c2b8e3a4d0012ab34cd |
| booleano | Si el despliegue utiliza TLS | true |
| 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 |
| 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 |
Campos a nivel de nodo
Cada elemento del nodes array incluye los siguientes campos:
Campo | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| 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 |
| string | Uno de: MONGOD (nodo de base de datos), MONGOS (router de clúster fragmentado) o MONGOT (nodo de búsqueda) | MONGOD |
| string | La versión de MongoDB el nodo se ejecuta | 8.0.12 |
| entero | Los núcleos de CPU provisionados por el nodo | 8 |
| entero | La memoria provisionada del nodo, en bytes | 34359738368 |
| entero o null | El almacenamiento provisionado del nodo, en bytes | 214748364800 |
| Booleano o nulo | Si el binario del nodo incluye el módulo empresarial. Vacío para MONGOT | true |
| string o nula | El nombre del conjunto réplica del nodo, como lo llamaste | RS0 |
| string o nula | Uno de: PRIMARIO, SECUNDARIO o ÁRBITRO | Primario |
| string o nula | El nombre del fragmento del nodo, como lo llamaste. Solo clústeres fragmentados | fragmento01 |
Campos de Copia de Seguridad (si están configurados)
Si el despliegue tiene configurada una copia de seguridad, el objeto backupConfig incluye los siguientes campos:
Campo | Tipo | Descripción | Ejemplo |
|---|---|---|---|
| string | Estado de la configuración de respaldo del despliegue. Uno de:
| INICIADO |
| entero | Con qué frecuencia se toman las instantáneas, en minutos | 360 |
| string | Uno de: BS (blockstore), FS (sistema de archivos), S3 (AWS S3 bucket), 3PSS (de terceros) o MRTS (multirregión temporal) | BS |
Solicitud de ejemplo
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"Respuesta de ejemplo (902 y 8028 y posteriores)
{ "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"}