/ /

Trabajos de colección de registros del servidor

/ /

Recursos

Trabajos de colección de registros del servidor

Docs Home

Gestión

Gerente de Operaciones

API

Recursos

Trabajos de colección de registros del servidor

Descargar los registros de Ops Manager servidor

Utiliza este punto de acceso para descargar un .tar.gz fichero que contenga todas las entradas de registro que Ops Manager recolectó para la tarea especificada. No se puede descargar de una tarea cuyo estado es IN_PROGRESS o EXPIRED. Si una tarea falla parcialmente, el fichero solo incluye las entradas de registro que Ops Manager recogió con éxito.

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

Resource

GET /admin/omLogCollectionJobs/{JOB-ID}:download

Roles necesarios

Requiere que la clave API que llame a este endpoint tenga el rol Global Read Only.

Request Parameters

Parámetros de ruta de solicitud

Nombre	Tipo	Necesidad	Descripción
`JOB-ID`	string	Requerido	string única de 24dígitos hexadecimales que identifica la tarea de colección de registros del servidor Ops Manager. Para encontrar un ID de trabajo, llama a Obtener todos los trabajos de colección de registros del servidor de Ops Manager.

Parámetros de Solicitud Query

Los siguientes parámetros de query son opcionales:

Nombre	Tipo	Necesidad	Descripción	predeterminado
bonito	booleano	Opcional	Indicador que muestra si el cuerpo de la respuesta está en formato pretty-print.	`false`
envelope	booleano	Opcional	Bandera que indica si se debe o no envolver la respuesta en un sobre. Algunos clientes API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar esto, ajusta envelope=true en la query. Para los endpoints que devuelven un resultado, el cuerpo de la respuesta incluye: `status`: Código de respuesta HTTP `content`: Cuerpo de respuesta esperado	`false`

Parámetros del cuerpo de la solicitud

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

Respuesta

Este endpoint devuelve un flujo binary con Content-Type: application/gzip y el formato de nombre de archivo om-logs_{timestamp}.tar.gz. El fichero utiliza la siguiente distribución:

om-server-1.example.com/
   application/
      mms0.log
      mms0.20260412.log
   http_access/
      mms0-access.log
   migration/
      mms-migration.log
om-server-2.example.com/
   application/
      mms0.log
   http_access/
      mms0-access.log
      mms0-access.20260412.log

Importante

Cuando llame a este endpoint con curl, debe pasar --output y un nombre de archivo. De lo contrario, curl escribe el archivo binary en tu terminal.

Solicitud de ejemplo

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/gzip" \
     --output om-logs.tar.gz \
     --request GET \
     "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/omLogCollectionJobs/{JOB-ID}:download"

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/gzip
Content-Disposition: attachment; filename="om-logs_{timestamp}.tar.gz"
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

Este extremo no devuelve un cuerpo de respuesta JSON.

Volver

GET un trabajo

Extender la expiración