Docs Home

/ /

Trabajos de recopilación de registros del servidor

Docs Home

/ /

Recursos

Trabajos de recopilación de registros del servidor

Docs Home

Gestión

Gerente de Operaciones

API

Recursos

Trabajos de recopilación de registros del servidor

Obtenga una tarea de recopilación de registros del servidor de Ops Manager

Utilice este punto final para recuperar un único trabajo de recopilación de registros del servidor de Ops Manager mediante su identificador.

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

Resource

GET /admin/omLogCollectionJobs/{JOB-ID}

Roles necesarios

Requiere que el La API Key que llama a este endpoint tiene la Global Read Only rol.

Request Parameters

Parámetros de ruta de solicitud

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

Parámetros de Solicitud Query

Nombre	Tipo	Necesidad	Descripción	predeterminado
`verbose`	booleano	Opcional	Indicador que especifica si se deben incluir todos los trabajos secundarios en la respuesta.	`false`
`pretty`	booleano	Opcional	Indicador que señala si el cuerpo de la respuesta debe estar en un pretty-print formato.	`false`
`envelope`	booleano	Opcional	Indicador que especifica si se debe encapsular la respuesta. Algunos clientes de API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar esto, establezca `envelope=true` en la consulta.	`false`

Parámetros del cuerpo de la solicitud

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

Respuesta

La respuesta devuelve un único trabajo de recopilación de registros del servidor de Ops Manager.

Nombre	Tipo	Descripción
`id`	string	Cadena única de dígitos hexadecimales 24que identifica este trabajo.
`status`	string	Estado del trabajo. Devuelve uno de los siguientes valores: `SUCCESS` `FAILURE` `IN_PROGRESS` `MARKED_FOR_EXPIRY` `EXPIRED`
`creationDate`	string	Marca de tiempo, en formato ISO 8601 UTC, cuando Ops Manager creó el trabajo.
`expirationDate`	string	Marca de tiempo, en formato ISO 8601 UTC, cuando el trabajo expira y Ops Manager elimina automáticamente sus datos.
`finishDate`	string	Marca de tiempo, en formato ISO 8601 UTC, cuando el trabajo finalizó. `null` mientras el trabajo está en curso.
`servers`	Arreglo de cadenas	Lista de `serverId` valores incluidos en esta solicitud. Devuelto por List Active Ops Manager Servers.
`logTypes`	Arreglo de cadenas	Tipos de registro incluidos en esta solicitud. Devuelve uno o más de los siguientes valores: `APPLICATION` `HTTP_ACCESS` `MIGRATION`
`sizeRequestedPerFileBytes`	Número	Tamaño máximo solicitado, en bytes, por tipo de registro y por servidor.
`logCollectionFromDate`	string	Inicio del filtro de rango de tiempo, en formato ISO 8601 UTC. `null` si la solicitud no especificó un rango de tiempo.
`logCollectionToDate`	string	Fin del filtro de rango de tiempo, en formato ISO 8601 UTC. `null` si la solicitud no especificó un rango de tiempo.
`uncompressedSizeTotalBytes`	Número	Tamaño total sin comprimir, en bytes, de los datos de registro recopilados.
`sizeLimitHit`	booleano	Indicador que señala si Ops Manager truncó los datos recopilados de algún trabajo secundario porque los datos alcanzaron `sizeRequestedPerFileBytes`.
`downloadUrl`	string	URL desde la que puede descargar el archivo. Consulte Descargar registros del servidor de Ops Manager.
`childJobs`	arreglo	Lista de trabajos secundarios asociados a esta solicitud. Ops Manager incluye este campo solo cuando se establece `verbose=true`.

Documento incrustado de childJobs

Cada tarea secundaria representa la tarea de recopilación de registros para un servidor y un tipo de registro.

Nombre	Tipo	Descripción
`childJobs[n].serverId`	string	`serverId` del servidor de Ops Manager desde el cual este trabajo secundario recopila registros.
`childJobs[n].logCollectionType`	string	Tipo de registro que recopila este trabajo secundario. Devuelve uno de los siguientes valores: `APPLICATION` `HTTP_ACCESS` `MIGRATION`
`childJobs[n].status`	string	Estado de este trabajo secundario. Devuelve uno de los siguientes valores: `SUCCESS` `FAILURE` `IN_PROGRESS` `MARKED_FOR_EXPIRY` `EXPIRED`
`childJobs[n].startDate`	string	Marca de tiempo, en formato ISO 8601 UTC, cuando comenzó este trabajo secundario.
`childJobs[n].finishDate`	string	Marca de tiempo, en formato ISO 8601 UTC, cuando finalizó este trabajo secundario. `null` mientras el trabajo secundario está en curso.
`childJobs[n].errorMessage`	string	Mensaje de error que explica por qué falló este trabajo secundario. `null` si el trabajo secundario no falló.
`childJobs[n].sizeLimitHit`	booleano	Indicador que señala si Ops Manager truncó los datos recopilados de este trabajo secundario porque los datos alcanzaron `sizeRequestedPerFileBytes`.
`childJobs[n].uncompressedDiskspaceBytes`	Número	Espacio total en disco sin comprimir, en bytes, que utiliza este proceso secundario.

Solicitud de ejemplo

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --include \
     --request GET \
     "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/omLogCollectionJobs/{JOB-ID}?verbose=true&pretty=true"

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

{
  "id": "675a1234567890abcdef1234",
  "status": "SUCCESS",
  "creationDate": "2026-04-13T10:00:00Z",
  "expirationDate": "2026-04-20T10:00:00Z",
  "finishDate": "2026-04-13T10:02:30Z",
  "servers": [
    "om-server-1.example.com",
    "om-server-2.example.com"
  ],
  "logTypes": ["APPLICATION", "HTTP_ACCESS", "MIGRATION"],
  "sizeRequestedPerFileBytes": 5242880,
  "logCollectionFromDate": "2026-04-12T00:00:00Z",
  "logCollectionToDate": "2026-04-13T00:00:00Z",
  "uncompressedSizeTotalBytes": 15728640,
  "sizeLimitHit": false,
  "downloadUrl": "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/omLogCollectionJobs/675a1234567890abcdef1234:download",
  "childJobs": [
    {
      "serverId": "om-server-1.example.com",
      "logCollectionType": "APPLICATION",
      "status": "SUCCESS",
      "startDate": "2026-04-13T10:00:05Z",
      "finishDate": "2026-04-13T10:01:30Z",
      "errorMessage": null,
      "sizeLimitHit": false,
      "uncompressedDiskspaceBytes": 2621440
    },
    {
      "serverId": "om-server-1.example.com",
      "logCollectionType": "HTTP_ACCESS",
      "status": "SUCCESS",
      "startDate": "2026-04-13T10:00:05Z",
      "finishDate": "2026-04-13T10:02:00Z",
      "errorMessage": null,
      "sizeLimitHit": false,
      "uncompressedDiskspaceBytes": 1310720
    },
    {
      "serverId": "om-server-1.example.com",
      "logCollectionType": "MIGRATION",
      "status": "SUCCESS",
      "startDate": "2026-04-13T10:00:05Z",
      "finishDate": "2026-04-13T10:01:15Z",
      "errorMessage": null,
      "sizeLimitHit": false,
      "uncompressedDiskspaceBytes": 524288
    },
    {
      "serverId": "om-server-2.example.com",
      "logCollectionType": "APPLICATION",
      "status": "SUCCESS",
      "startDate": "2026-04-13T10:00:10Z",
      "finishDate": "2026-04-13T10:02:30Z",
      "errorMessage": null,
      "sizeLimitHit": false,
      "uncompressedDiskspaceBytes": 3145728
    }
  ]
}

Volver

Obtener todos los trabajos

Descargar registros