Criar um trabalho de coleção de registros do servidor do Ops Manager

Quando você cria um tarefa de coleção de registro de servidor do Ops Manager, o Ops Manager inicia tarefas em segundo plano para coletar os registros solicitados dos servidores de destino. Cada servidor coleta seus registros localmente, os compacta, criptografa e armazena o resultado no banco de dados de aplicativos. Use este ponto de extremidade para criar um novo tarefa.

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

Resource

POST /admin/omLogCollectionJobs

Funções obrigatórias

Exige que a chave de API que chama esse endpoint tenha a função Global Owner.

Parâmetros da solicitação

Parâmetros do caminho da solicitação

Este endpoint não usa parâmetros de caminho de solicitação HTTP.

Solicitar parâmetros de query

Os seguintes parâmetros de query são opcionais:

Nome	Tipo	necessidade	Descrição	Default
pretty	booleano	Opcional	Sinalizador que indica se o corpo da resposta está em um formato prettyprint.	`false`
envelope	booleano	Opcional	Sinalizador que indica se deve envolver a resposta em um envelope. Alguns clientes de API não podem acessar os cabeçalhos de resposta HTTP ou o código de status. Para corrigir isso, defina envelope=true na query. Para endpoints que retornam um resultado, o corpo da resposta inclui: `status`: Código de resposta HTTP `content`: Corpo de resposta esperado	`false`

Parâmetros do corpo da solicitação

Nome	Tipo	necessidade	Descrição
`servers`	array de strings	Opcional	Lista de valores `serverId` retornados por Listar servidores do Active Ops Manager. Se você omitir esse campo ou passar uma array vazia, o Ops Manager coletará registros de cada servidor ativo.
`logTypes`	array de strings	Opcional	Tipos de log para coletar. Cada elemento deve ser um dos seguintes valores: `APPLICATION` `HTTP_ACCESS` `MIGRATION` `DAEMON` O tipo de registro `DAEMON` pode ser coletado somente de servidores `BACKUP_DAEMON`. Os tipos de registro `APPLICATION`, `HTTP_ACCESS` e `MIGRATION` podem ser coletados somente de servidores `MMS_SERVER`. Se você omitir esse campo ou passar uma array vazia, o Ops Manager resolverá os tipos de log com base no tipo de servidor selecionado. Se você especificar um tipo de registro que não é válido para um servidor selecionado, o Ops Manager retornará um erro. O tipo de registro `DAEMON` está disponível somente quando a coleta de registro do daemon de backup está habilitada.
`sizeRequestedPerFileBytes`	número	Opcional	Tamanho máximo descompactado, em bytes, por tipo de log por servidor. Deve ser maior que 0. Se você omitir esse campo, o Ops Manager alocará automaticamente o armazenamento configurado restante nos servidores e tipos de log solicitados.
`logCollectionFromDate`	string	Opcional	Início do intervalo de tempo a ser coletado, no formato ISO 8601 UTC. Se você definir este campo, também deverá definir `logCollectionToDate`.
`logCollectionToDate`	string	Opcional	Fim da faixa de tempo a ser coletada, no formato ISO 8601 UTC. Se você definir este campo, também deverá definir `logCollectionFromDate`.

Observação

Quando você combina um limite de tamanho e uma faixa de tempo, o Ops Manager aplica o limite de tamanho como um limite de segurança. Se os registros no intervalo de tempo excederem o limite de tamanho, o Ops Manager retornará os registros mais recentes até o limite de tamanho e definirá sizeLimitHit como true nos trabalhos filhos afetados. Se você omitir sizeRequestedPerFileBytes ao lado de um intervalo de tempo, o Ops Manager alocará automaticamente o armazenamento configurado restante nos servidores e tipos de registro solicitados.

O gerente de operações rejeita uma solicitação de criação que viole uma destas regras:

Regra	Código de erro	HTTP status
`sizeRequestedPerFileBytes` Deve ser maior que 0.	`INVALID_LOG_REQUEST_SIZE`	400
`logCollectionFromDate` e `logCollectionToDate` devem ser definidos juntos.	`OM_LOG_INCOMPLETE_TIME_RANGE`	400
`logCollectionFromDate` must precede `logCollectionToDate`.	`OM_LOG_INVALID_TIME_RANGE`	400
`logCollectionFromDate` não deve ser no futuro.	`OM_LOG_TIME_RANGE_IN_FUTURE`	400
A faixa de tempo não deve exceder 7 dias.	`OM_LOG_TIME_RANGE_TOO_LARGE`	400
O intervalo de tempo não deve começar antes do histórico máximo de log que o administrador do Ops Manager configurou.	`OM_LOG_TIME_RANGE_TOO_OLD`	400
Cada valor em `servers` deve identificar um servidor registrado e ativo do Ops Manager.	`INACTIVE_SERVER` ou `INVALID_SERVER`	400
O número de tarefas simultâneas não deve exceder 4.	`TOO_MANY_OM_LOG_JOBS`	429
O armazenamento estimado não deve exceder o limite de armazenamento que o administrador do Ops Manager configurou para a coleção de log.	`OM_LOG_STORAGE_LIMIT_EXCEEDED`	413
`DAEMON` tipo de registro solicitado quando a coleta de registro do daemon de backup está desativada.	`OM_LOG_DAEMON_DISABLED`	400
Um tipo de log em `logTypes` não é válido para um ou mais servidores em `servers`.	`OM_LOG_INVALID_SERVER_LOG_TYPE_COMBINATION`	400
O tamanho solicitado por arquivo excede o armazenamento restante após a alocação para outras tarefas.	`OM_LOG_INSUFFICIENT_STORAGE_PER_FILE`	413

Resposta

Nome	Tipo	Descrição
`id`	string	Identificador exclusivo da nova tarefa de coleta de log do servidor do Ops Manager.

Exemplo de solicitação

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \
     --include \
     --request POST \
     "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/omLogCollectionJobs?pretty=true" \
     --data '
       {
         "servers": [
           "om-server-1.example.com",
           "om-server-2.example.com"
         ],
         "logTypes": ["APPLICATION", "HTTP_ACCESS"],
         "sizeRequestedPerFileBytes": 5242880,
         "logCollectionFromDate": "2026-04-13T10:00:00Z",
         "logCollectionToDate": "2026-04-14T10:00:00Z"
       }'

Exemplo de solicitação (OM misto e servidores do Backup Daemon )

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \
     --include \
     --request POST \
     "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/omLogCollectionJobs?pretty=true" \
     --data '
       {
         "servers": [
           "om-server-1.example.com",
           "daemon-host-1.example.com"
         ],
         "logTypes": ["APPLICATION", "DAEMON"],
         "sizeRequestedPerFileBytes": 5242880
       }'

Exemplo de resposta

Cabeçalho de resposta

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 201 Created
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}

Corpo de resposta

{ "id": "675a1234567890abcdef1234" }

Voltar

Listar servidores ativos

Obter todos os trabalhos