/ /

/ /

Gerente de Operaciones

API

Recursos

Telemetría

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.

Roles necesarios

Este endpoint requiere una clave API que tenga la Global Owner role.

Endpoint

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

GET /collection/details

Solicitud

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 corporales

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 si el sistema recolecta y envía telemetría.
último_envio_exitoso	datetime	Fecha y hora del último envío exitoso de telemetría.
próximo_trabajo	datetime	Fecha y hora en la que está programado el próximo envío de telemetría.
Datos	arreglo	Matriz de objetos definidos en el objeto incrustado Datos de telemetría.

Objeto incrustado de datos de telemetría

Cada elemento en el arreglo data describe los detalles de telemetría para la instalación de Ops Manager.

Nombre	Tipo	Descripción
app_db_nodes	entero	Número de nodos de AppDB que utiliza esta instalación de Ops Manager.
uuid	string	Identificador único estático para esta instalación de Ops Manager.
os	Arreglo de cadenas	Sistemas operativos que se ejecutan en los hosts de Ops Manager.
Versión	string	Versión actual de Ops Manager.
Instancias	entero	Número de instancias de Ops Manager en esta instalación.
backup_daemons	entero	Número de demonios de respaldo que se ejecutan en esta instalación.
auth_method	string	Método de autenticación que utiliza Ops Manager. Valores posibles: `DB`, `LDAP` o `SAML`.
UPC	arreglo de enteros	Número de núcleos de CPU provisionados para cada host de Ops Manager.
memoria	arreglo de enteros	Cantidad de memoria provisionada para cada host de Ops Manager.
infraestructura	string	Tipo de infraestructura que aloja Ops Manager. Valores posibles: `Kubernetes`, `VM`, o `Bare Metal`.
Proyectos	entero	Número total de proyectos que existen actualmente.
orgs	entero	Número total de organizaciones que existen actualmente.
despliegues	arreglo	Matriz de objetos definidos en el objeto integrado de implementaciones de telemetría.

Implementaciones de telemetría objeto incrustado

Cada elemento en el arreglo deployments describe una implementación de MongoDB que Ops Manager administra.

Nombre	Tipo	Descripción
Versión	Arreglo de cadenas	Versiones de MongoDB que utiliza la implementación.
uuid	string	Identificador único estático para la implementación.
tls_habilitado	booleano	Indica si TLS está habilitado para la implementación.
auth_method	string	Método de autenticación que utiliza la implementación. Valores posibles: `MONGODB-CR`, `GSSAPI`, `PLAIN` o `MONGODB-X509`.
tipo	string	Tipo de implementación. Valores posibles: `SC`, `RS`, o `SA`.
nodes	entero	Número de nodos en la implementación si es un set de réplicas.
shards	entero	Cantidad de particiones en la implementación si se trata de un clúster.
data_size	entero	Tamaño total de datos para la implementación, sin incluir los metadatos locales.
Edición	Objeto	Objeto que contiene dos claves, `community` y `enterprise`. Cada clave tiene un valor entero que representa el número de nodos de esa edición en la implementación.

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

Encabezado de respuesta

HTTP/1.1 401 Unauthorized
Content-Type: application/json;charset=ISO-8859-1
Date: {dateInUnixFormat}
WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false
Content-Length: {requestLengthInBytes}
Connection: keep-alive

HTTP/1.1 200 OK
Vary: Accept-Encoding
Content-Type: application/json
Strict-Transport-Security: max-age=300
Date: {dateInUnixFormat}
Connection: keep-alive
Content-Length: {requestLengthInBytes}
X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}

Respuesta del cuerpo

{
  "data": {
    "app_db_nodes": 1,
    "auth_method": "DB",
    "backup_daemons": 3,
    "cpu": [
      14,12
    ],
    "infrastructure": "Bare Metal",
    "instances": 2,
    "memory": [
      "3221225472","221225472"
    ],
    "os": [
      "RHEL 8.10 aarch64","RHEL 8.11 aarch64"
    ],
    "orgs": 3,
    "projects": 12,
    "uuid": "84248c7e-94df-4a0c-942a-dfb1fa987edd",
    "version": "8.0.13",
    "deployments": [
      {
        "auth_method": "MONGODB-CR",
        "data_size": 3221225472,
        "edition": {
          "community": 3,
          "enterprise": 0
       },
        "nodes": 3,
        "tls_enabled": true,
        "type": "RS",
        "uuid": "6907dd45d61b992049366140",
        "version": [
          "8.15","7.11"
        ]
       },
       {
         "auth_method": "MONGODB-CR",
           "data_size": 221225472,
           "edition": {
             "community": 1,
             "enterprise": 2
             },
             "shards": 3,
             "tls_enabled": false,
             "type": "SC",
             "uuid": "6907de15d61b9920493664ca",
             "version": [
               "8.15"
             ]
         }
     ],
  },
  "enabled": true,
  "last_successful_send": "2025-10-02T22:26:10Z",
  "next_job": "2025-10-09T22:26:10Z"
}

Volver

Telemetría

Conmutar estado de telemetría