/ /

/ /

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 punto final 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 punto final no utiliza parámetros de ruta de solicitud HTTP.

Parámetros de consulta

Este punto final no utiliza parámetros de consulta de solicitud HTTP.

Parámetros corporales

Este punto final no utiliza parámetros del cuerpo de la 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 recopila y envía telemetría.
último envío exitoso	datetime	Fecha y hora del último envío de telemetría exitoso.
próximo_trabajo	datetime	Fecha y hora en 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	matriz 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.
demonios de respaldo	entero	Número de demonios de respaldo que se ejecutan en esta instalación.
método de autenticación	string	Método de autenticación que utiliza Ops Manager. Valores posibles: `DB`, `LDAP` o `SAML`.
UPC	matriz de números enteros	Número de núcleos de CPU aprovisionados para cada host de Ops Manager.
memoria	matriz de números enteros	Cantidad de memoria aprovisionada para cada host de Ops Manager.
infraestructura de	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.
organizaciones	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 de objetos integrados

Cada elemento de la matriz deployments describe una implementación de MongoDB que administra Ops Manager.

Nombre	Tipo	Descripción
Versión	matriz 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.
método de autenticación	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 conjunto de réplicas.
shards	entero	Cantidad de particiones en la implementación si se trata de un clúster.
tamaño de datos	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.

Ejemplo de solicitud

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"

Ejemplo de respuesta

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}

Cuerpo de respuesta

{
  "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

Alternar estado de telemetría