Obter todos os eventos da organização

Nesta página

Funções obrigatórias

Solicitar
Parâmetros do caminho da solicitação
Solicitar parâmetros de query
Parâmetros do corpo da solicitação
Resposta
documento de resposta
results documento incorporado
Exemplo de solicitação
Exemplo de resposta
Cabeçalho de resposta
Corpo de resposta

O MongoDB Ops Manager v6.0 será EOL em janeiro 2025. Atualize para uma versão superior do MongoDB Ops Manager o mais rápido possível.

Funções obrigatórias

Sua chave de API deve ter a função Organization Member para chamar esse recurso com êxito.

Solicitar

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

GET /orgs/{orgId}/events

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

Parâmetros de query únicos

Esse endpoint aceita os seguintes parâmetros de query para filtrar eventos retornados:

Nome	Tipo	Descrição	Default
eventType	string	Retornar apenas eventos dos tipos especificados. Para revisar os tipos de eventos que geram alertas, consulte Tipos de Alerta. Para obter uma lista completa de eventos incluídos no registro de auditoria do Ops Manager, consulte Eventos de auditoria.
includeRaw	booleano	Especifica se o documento `raw` deve ser incluído na saída. O documento `raw` contém metainformações adicionais sobre o evento. Importante Os valores no documento `raw` estão sujeitos a alterações. Não confie em valores `raw` para monitoramento oficial.	`false`
minDate	string	Retorna apenas eventos para os quais a data criada é maior ou igual ao Registro de data/hora especificado emISO formato de data e hora em 8601 UTC.
maxDate	string	Retornar apenas eventos para os quais a data criada é menor ou igual ao Registro de data/hora especificado na ISO formato de data 8601 e hora em UTC.

Parâmetros de query comuns

Esse endpoint também aceita os parâmetros de query comuns a todos os endpoints que retornam listas de valores:

Nome

Tipo

Descrição

Default

pageNum

inteiro

Número da página (com base em índice 1).

1

itemsPerPage

inteiro

Número de itens a serem devolvidos por página, até um máximo de 500.

100

pretty

booleano

Indica se o corpo da resposta deve estar em formato prettyprint.

false

envelope

booleano

Indica se deseja ou não 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, configure "envelope" : true na query.

Para endpoints que retornam um resultado, o corpo da resposta inclui:

Status	Código de resposta HTTP
envelope	Corpo de resposta esperado

Para endpoints que retornam uma lista de resultados, o objeto results é um envelope. O Ops Manager adiciona o campo status ao corpo da resposta.

none

Parâmetros do corpo da solicitação

Este endpoint não usa parâmetros do corpo da solicitação HTTP.

Resposta

documento de resposta

O documento JSON de resposta inclui uma array de objetos result , uma array de objetos link e uma contagem do número total de objetos result recuperados.

Nome	Tipo	Descrição
`results`	array	A array inclui um objeto para cada item detalhado na seção Documento incorporado`results` .
`links`	array	A array inclui um ou mais links para sub-recursos e/ou recursos relacionados. As relações entre URLs são explicadas na Especificação de links da web.
`totalCount`	número	Contagem de números inteiros do número total de itens no conjunto de resultados. Pode ser maior que o número de objetos na array results se todo o conjunto de resultados for paginado.

`results` documento incorporado

Cada resultado é um evento.

Nome	Tipo	Descrição
alertId	string	Identificador único do alerta associado a este evento.
alertConfigId	string	Identificador único para a configuração de alerta associada ao `alertId`.
apiKeyId	string	Identificador único da chave de API que acionou este evento. Se este campo estiver presente na resposta, o Ops Manager não retornará o campo `userId` .
clusterId	string	Identificador único do cluster ao qual este evento se aplica.
clusterName	string	Nome do cluster ao qual este evento se aplica.
collection	string	Nome da collection na qual o evento ocorreu. Este campo pode estar presente quando o `eventTypeName` é `DATA_EXPLORER` ou `DATA_EXPLORER_CRUD`.
Criado	string	Carimbo de data/hora na ISO 8601 formato de data e hora em UTC quando esse evento foi acionado.
currentValue	objeto	Valor atual da métrica que acionou este evento.
currentValue .number	número	Valor da métrica.
currentValue .units	string	Unidades relevantes para o valor. Exemplo Uma métrica que mede o consumo de memória teria uma medida de bytes, enquanto uma métrica que mede o tempo teria uma unidade de tempo. Os valores aceitos são: `RAW` `BITS` `BYTES` `KILOBITS` `KILOBYTES` `MEGABITS` `MEGABYTES` `GIGABITS` `GIGABYTES` `TERABYTES` `PETABYTES` `MILLISECONDS` `SECONDS` `MINUTES` `HOURS` `DAYS`
database	string	Nome do reconhecimento de data center no qual ocorreu o evento. Este campo pode estar presente quando o `eventTypeName` é `DATA_EXPLORER` ou `DATA_EXPLORER_CRUD`.
diffs	Array de objetos	Alterações feitas na implantação durante este evento. Observação O Ops Manager retorna elementos diferentes dependendo do que foi alterado: privilégios ou roles de usuário, trabalhos de restauração, módulos de automação e assim por diante. A lista desta array e seus objetos não é exaustiva.
diffs .id	string	Identificador único para as diferenças executadas neste evento.
diffs .params	Array de objetos	collection de alterações feitas no recurso fornecido.
diffs .params .display	string	Etiqueta exibida no console no feed de atividades quando a alteração foi feita.
diffs .params .new	string	Novo estado do parâmetro que foi alterado.
diffs .params .old	string	Estado inicial do parâmetro que foi alterado.
diffs .params .param	string	Nome do parâmetro que foi alterado.
diffs .status	string	Tipo de alteração feita nesse recurso. `NEW` `MODIFIED` `REMOVED` `SHUTDOWN` `STARTUP` `RESTORE` `RESTART`
diffs .type	string	Recurso para o qual a alteração foi feita. `AUTH` `AUTOMATION_AGENT` `BACKUP_AGENT` `BI_CONNECTOR` `MONITORING_AGENT` `PROCESS` `REPLICA_SET` `ROLES` `USERS`
eventTypeName	string	Nome da circunstância que acionou este evento. Para revisar os tipos de eventos que geram alertas, consulte Tipos de Alerta. Para obter uma lista completa de eventos incluídos no registro de auditoria do Ops Manager, consulte Eventos de auditoria.
groupId	string	Identificador único do projeto em que este evento ocorreu.
hostId	string	Identificador único do host no qual ocorreu este evento.
nome do host	string	Nome do host, FQDN, endereço IPv4 ou endereço IPv6 do host no qual o evento ocorreu.
id	string	Identificador único para este evento.
isGlobalAdmin	booleano	Sinalizador que indica se o usuário que acionou esse evento tem a role `Global Monitoring Administrator` .
links	array de objetos	Um ou mais links para sub-recursos e/ou recursos relacionados. Todas as arrays `links` nas respostas incluem pelo menos um link chamado `self`. Os relacionamentos entre URLs são explicados na Especificação de links da web.
metricName	string	Nome da medição cujo valor ficou fora do limite.
opType	string	Tipo de operação que gerou o evento. Este campo está presente quando `eventTypeName` é `DATA_EXPLORER` ou `DATA_EXPLORER_CRUD`.
Porta	inteiro	Porta do host associado a este evento.
chave pública	string	Chave pública associada à chave de API que acionou esse evento. Se este campo estiver presente na resposta, o Ops Manager não retornará o campo `username` .
bruto	documento	Metainformações adicionais sobre o evento. Este campo aparece somente quando o parâmetro de query `includeRaw` é `true`. Importante Os valores no documento `raw` estão sujeitos a alterações. Não confie em valores `raw` para monitoramento oficial.
remotoAddress	string	Endereço IP associado ao usuário do Ops Manager (userId) que acionou o evento.
ReplicaSetName	string	Nome do conjunto de réplicas.
shardName	string	Nome do fragmento associado ao evento.
targetPublicKey	string	Chave pública da chave API direcionada pelo evento.
targetUsername	string	Nome de usuário do Ops Manager direcionado por este evento.
teamId	string	Identificador único para a equipe do Ops Manager associado a este evento.
ID do usuário	string	Identificador único para o usuário do Ops Manager que acionou este evento. Se este campo estiver presente na resposta, o Ops Manager não retornará o campo `apiKeyId` .
nome de usuário	string	Nome de usuário do Ops Manager que acionou este evento. Se este campo estiver presente na resposta, o Ops Manager não retornará o campo `publicKey` .
accessListEntry	string	Entrada da lista de acesso da chave API direcionada pelo evento.

Exemplo de solicitação

curl --user "{publicKey}:{privateKey}" --digest \
     --header "Accept: application/json" \
     --include \
     --request GET "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/orgs/{orgId}/events?pretty=true"

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

Corpo de resposta

1 {
2   "alertConfigId": "{alertConfigId}",
3   "alertId": "{alertId}",
4   "clusterId": "{clusterId}",
5   "clusterName": "Test Cluster",
6   "created": "2018-06-11T12:34:56Z",
7   "currentValue": {
8     "number": 50,
9     "units": "RAW"
10   },
11   "eventTypeName": "OUTSIDE_METRIC_THRESHOLD",
12   "groupId": "{groupId}",
13   "hostId": "{hostId}",
14   "hostname": "db.example.com",
15   "id": "{globalAlertId}",
16   "isGlobalAdmin": false,
17   "maintenanceWindowId": "{maintenanceWindowId}",
18   "metricName": "OPCOUNTER_CMD",
19   "orgId": "{orgId}",
20   "port": 27017,
21   "remoteAddress": "192.168.1.1",
22   "replicaSetName": "rs1",
23   "shardName": "sh1",
24   "userId": "{userId}",
25   "username": "john.doe@example.com",
26   "targetUsername": "jane.doe@example.com",
27   "teamId": "{teamId}"
28 }

Voltar

Eventos

Obter um evento da organização

1	{
2	"alertConfigId": "{alertConfigId}",
3	"alertId": "{alertId}",
4	"clusterId": "{clusterId}",
5	"clusterName": "Test Cluster",
6	"created": "2018-06-11T12:34:56Z",
7	"currentValue": {
8	"number": 50,
9	"units": "RAW"
10	},
11	"eventTypeName": "OUTSIDE_METRIC_THRESHOLD",
12	"groupId": "{groupId}",
13	"hostId": "{hostId}",
14	"hostname": "db.example.com",
15	"id": "{globalAlertId}",
16	"isGlobalAdmin": false,
17	"maintenanceWindowId": "{maintenanceWindowId}",
18	"metricName": "OPCOUNTER_CMD",
19	"orgId": "{orgId}",
20	"port": 27017,
21	"remoteAddress": "192.168.1.1",
22	"replicaSetName": "rs1",
23	"shardName": "sh1",
24	"userId": "{userId}",
25	"username": "john.doe@example.com",
26	"targetUsername": "jane.doe@example.com",
27	"teamId": "{teamId}"
28	}