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.

Conmutar estado de telemetría

Habilita o deshabilita la recopilación de telemetría para tu instalación de Ops Manager.

Importante

Empezando en Ops Manager 9.0.2 y 8.0.28, este endpoint activa o desactiva la telemetría de uso del producto. Desactivarlo requiere una exención activa de telemetría en la clave de licencia instalada. Ops Manager comprueba la clave de licencia en cada solicitud. Para saber cómo solicitar una exención, consulta Exención de Telemetría.

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

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

PATCH /collection/status

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

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

Nombre
Tipo
Necesidad
Descripción

habilitado

booleano

Requerido

Configura en true para habilitar la telemetría, o false para desactivar la telemetría. Comenzando en Ops Manager 9.0.2 y 8.0.28, false desactiva la telemetría de uso del producto: Ops Manager deja de recogerla y enviarla, y next_job pasa a ser null. Configurar false requiere una exención activa de telemetría en la clave de licencia instalada. Para saber cómo solicitar una exención, consulta Exención de Telemetría

Este endpoint devuelve un objeto JSON vacío.

curl --user "{publicApiKey}:{privateApiKey}" --digest \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --include \ --request PATCH "https://<OpsManagerHost>:<Port>/api/private/v1.0/telemetry/collection/status" \ --data '{"enabled": false}'
HTTP/1.1 401 UnauthorizedContent-Type: application/json;charset=ISO-8859-1Date: {dateInUnixFormat}WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=falseContent-Length: {requestLengthInBytes}Connection: keep-alive
HTTP/1.1 400 Bad RequestContent-Type: application/json;charset=ISO-8859-1Date: {dateInUnixFormat}X-MongoDB-Service-Version: gitHash={gitHash};versionString={ApplicationVersion}Content-Length: {requestLengthInBytes}
HTTP/1.1 200 OKVary: Accept-EncodingContent-Type: application/jsonStrict-Transport-Security: max-age=300Date: {dateInUnixFormat}Connection: keep-aliveContent-Length: {requestLengthInBytes}X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
{}

Esta sección se aplica al Jefe de Operaciones 9.0.2, 8.0.28, y posteriores.

Si desactivas la telemetría de uso de producto sin una exención activa de telemetría en la clave de licencia instalada, el endpoint devuelve un error de 403 y no realiza ningún cambio. El cuerpo del error dice:

{ "details": "Product usage collection requires a license telemetry exemption", "error": "Forbidden" }

El endpoint Retrieve Telemetry Data sigue informando "enabled": true. Con una excepción activa, la solicitud tiene éxito y devuelve un objeto JSON vacío ({}).