/ /

Recursos

Trabajos de recopilación de registros

Docs Home

Gestión

Gerente de Operaciones

API

Recursos

Trabajos de recopilación de registros

Crear una tarea colectiva de registro

Nota

Grupos y proyectos son términos sinónimos. Tu {PROJECT-ID} es el mismo que tu id. de proyecto. Para los grupos existentes, su ID de grupo/ID del grupo seguirá siendo el mismo. Esta página utiliza el término más familiar grupo al referirse a descripciones. El endpoint se mantiene tal como se indica en el documento.

Cuando crea una tarea de recopilación de registros, Ops Manager inicia una tarea en segundo plano para descargar los registros de la implementación de Ops Manager especificada. Utiliza este punto final para crear una nueva tarea de colección de registros.

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

Resource

POST /groups/{GROUP-ID}/logCollectionJobs

Parámetros de la ruta de solicitud

Nombre	Tipo	Necesidad	Descripción
ID del grupo	string	Requerido	Cadena única de 24 dígitos hexadecimales que identifica el trabajo de solicitud de recopilación de registros.

Parámetros de Solicitud Query

Los siguientes parámetros de query son opcionales:

Nombre

Tipo

Necesidad

Descripción

predeterminado

bonito

booleano

Opcional

Indicador que señala si el cuerpo de la respuesta debe estar en un pretty-print formato.

false

envelope

booleano

Opcional

Bandera que indica si se debe o no envolver la respuesta en un sobre.

Algunos Los clientes de laAPI no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar esto, configure envelope=true en la consulta.

Para los endpoints que devuelven un resultado, el cuerpo de la respuesta incluye:

Nombre	Descripción
`status`	Código de respuesta HTTP
`content`	Cuerpo de respuesta esperado

false

Parámetros del cuerpo de la solicitud

Nombre	Tipo	Necesidad	Descripción
resourceType	string	Requerido	Tipo de recurso del que recoger registros. Debe ser uno de los siguientes valores: `CLUSTER`para un clúster fragmentado. `PROCESS`, para un nodo en el conjunto de réplicas. `REPLICASET`, para un set de réplicas`.
nombreDelRecurso	string	Requerido	Nombre del recurso del que se recopilarán los registros. El tipo de recurso define el valor: Para el `CLUSTER` `resourceType`, el valor es el nombre de la implementación o el `CLUSTER-ID`. Por ejemplo, `my-deployment`. Para obtener este valor, utiliza el /groups/{GROUP-ID}/clusters/{CLUSTER-ID} punto final. Para el `PROCESS` `resourceType`, el valor es el nombre del set de réplicas seguido por el nombre del nodo. Se puede mencionar, por ejemplo, `Cluster0-shard-1-node-0`. Para obtener este valor, utilice el punto de conexión /groups/{PROJECT-ID}/automationConfig. El valor se encuentra en el `processes.name` parámetro. Para obtener el nombre del conjunto de réplicas, la lista de nodos y otra información, acceda al clúster y ejecute `rs.conf()._id` `rs.status()`y. Para el `REPLICASET` `resourceType`, el valor es el nombre del set de réplicas en el clúster seguido por el nombre de la partición. Se puede mencionar, por ejemplo, `test-123abc-shard-0`.
tamañoSolicitadoPorArchivoBytes	Número	Requerido	Tamaño de cada entrada de registro en bytes.
typeslog	arreglo	Requerido	Matriz de cadenas que especifica los tipos de registros que se recopilarán. Cada elemento de la matriz debe tener uno de los siguientes valores: `AUTOMATION_AGENT` `BACKUP_AGENT` `MONITORING_AGENT` `MONGODB` `FTDC`
redactado	booleano	Requerido	Si se establece en `true`, los correos electrónicos, nombres de host, direcciones IP y espacios de nombres en las respuestas de API que involucran este trabajo se reemplazan con valores de cadena aleatorios.

Respuesta

Nombre	Tipo	Descripción
ID	string	Identificador único de la tarea de recopilación de registros creada.

Solicitud de ejemplo

1 curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
2      --header "Accept: application/json" \
3      --header "Content-Type: application/json" \
4      --include \
5      --request POST "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/logCollectionJobs?pretty=true" \
6      --data '
7        {
8          "resourceType": "PROCESS",
9          "resourceName": "my_deployment_1",
10          "redacted": true,
11          "sizeRequestedPerFileBytes": 10000000,
12          "logTypes": [
13              "FTDC",
14              "MONGODB",
15              "AUTOMATION_AGENT"
16          ]
17        }'

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

Respuesta del cuerpo

1 { "id": "5c81086e014b76a3d85e1113" }

Volver

Descargar registros

Prolongar

1	curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
2	--header "Accept: application/json" \
3	--header "Content-Type: application/json" \
4	--include \
5	--request POST "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/logCollectionJobs?pretty=true" \
6	--data '
7	{
8	"resourceType": "PROCESS",
9	"resourceName": "my_deployment_1",
10	"redacted": true,
11	"sizeRequestedPerFileBytes": 10000000,
12	"logTypes": [
13	"FTDC",
14	"MONGODB",
15	"AUTOMATION_AGENT"
16	]
17	}'