Menu Docs
Página inicial do Docs
/
MongoDB Ops Manager
/ / / /

Criar uma configuração de alerta global

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
  • Exemplo de solicitação
  • Exemplo de resposta
  • Cabeçalho de resposta
  • Corpo de resposta

Crie uma configuração de alerta global.

Você pode chamar esse endpoint com sucesso com qualquer um dos seguintes roles atribuídos:

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

POST /globalAlertConfigs

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

Nome
Tipo
necessidade
Descrição
Default
pretty
booleano
Opcional
Sinalizador indicando se o corpo da resposta deve estar em um prettyprint formato.
false
envelope
booleano
Opcional

Sinalizador que indica se deseja ou não envolver a resposta em um envelope.

Alguns clientes da 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:

Nome
Descrição
Status
Código de resposta HTTP
envelope
Corpo de resposta esperado
false
Parâmetro do corpo
Tipo
necessidade
Descrição
enabled
booleano
Opcional
Alternar que especifica se a configuração de alerta está habilitada.
eventTypeName
string
Obrigatório

Tipo de evento para o qual esta configuração de alerta Atlas Triggers um alerta.

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.

forAllGroups
booleano
Obrigatório

Alternar que especifica se a configuração de alerta global se aplica a todos os grupos. Também afeta se você pode usar a array tags para direcionar a configuração para grupos específicos.

Se true, a configuração se aplica a todos os grupos. Você pode direcionar a configuração de alerta para grupos específicos através da matriz tags .

Se false, a configuração se aplica somente aos grupos especificados na array groupIds . Você deve especificar pelo menos um projeto na array groupIds . Você não pode usar a array tags para essa configuração de alerta.

groupIds
array de strings
Opcional
IDs dos grupos aos quais essa configuração de alerta se aplica. Este campo se aplica somente se forAllGroups estiver definido como false.
matchers
Array de objetos
Condicional

Regras a serem aplicadas ao combinar um objeto com esta configuração de alerta global. MongoDB Ops Manager verifica apenas entidades que correspondem a todas essas regras para uma condição de alerta.

Você pode filtrar usando a array matchers somente quando o eventTypeName especifica um evento para um host, conjunto de réplicas ou cluster fragmentado.

matchers
.fieldName
string
Condicional

Nome do campo no objeto de destino ao qual corresponder.

  • Os alertas do host oferecem suporte aos seguintes campos:

    • HOSTNAME

    • PORT

    • HOSTNAME_AND_PORT

    • REPLICA_SET_NAME

    • TYPE_NAME

  • Os alertas de conjunto de réplicas suportam estes campos:

    • REPLICA_SET_NAME

    • SHARD_NAME

    • CLUSTER_NAME

  • Os alertas de cluster fragmentados suportam estes campos:

    • CLUSTER_NAME

    • SHARD_NAME

Todos os outros tipos de alertas não suportam correspondedores.

matchers
.operator
string
Condicional

Operador para testar o valor do campo. Os valores aceitos são:

  • EQUALS

  • NOT_EQUALS

  • CONTAINS

  • NOT_CONTAINS

  • STARTS_WITH

  • ENDS_WITH

  • REGEX

matchers
.value
string
Condicional

Valor para testar com o operador especificado.

Se matchers.fieldName estiver definido como TYPE_NAME, você poderá corresponder nos seguintes valores:

  • PRIMARY

  • SECONDARY

  • STANDALONE

  • CONFIG

  • MONGOS

metricThreshold
objeto
Condicional
Limite que faz com que essa configuração de alerta trigger um alerta. Só é necessário se eventTypeName estiver definido como OUTSIDE_METRIC_THRESHOLD.
metricThreshold
.metricName
string
Condicional
Nome da métrica a ser verificada. Suporta os mesmos valores que o campo metricName do recurso globalAlerts . Para obter uma lista de valores possíveis, consulte Tipos de medição para alertas globais.
metricThreshold
.mode
string
Condicional
É definido como AVERAGE e calcula o valor da métrica atual como uma média.
metricThreshold
.operator
string
Condicional

Operador para aplicar ao verificar o valor da métrica atual em relação a metricThreshold.threshold. Os valores possíveis são:

  • GREATER_THAN

  • LESS_THAN

metricThreshold
.threshold
número
Condicional
Valor limite fora do qual essa configuração de alerta Atlas Triggers um alerta.
metricThreshold
.units
string
Condicional

Unidades para metricThreshold.threshold. As unidades dependem do tipo de métrica.

Os valores aceitos são:

  • RAW

  • BITS

  • BYTES

  • KILOBITS

  • KILOBYTES

  • MEGABITS

  • MEGABYTES

  • GIGABITS

  • GIGABYTES

  • TERABYTES

  • PETABYTES

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Por exemplo, uma métrica que mede o consumo de memória pode usar BYTES, enquanto uma métrica que mede o tempo pode usar HOURS.

notifications
Array de objetos
Obrigatório
Notificações que o MongoDB Ops Manager envia quando detecta um alerta descrito por esta configuração de alerta.
notifications
.apiToken
string
Condicional
Token de API do Slack ou token de Bot. Aceito apenas para SLACK notificações. Se, posteriormente, o token se tornar inválido, o MongoDB Ops Manager enviará um e-mail ao proprietário do projeto e removerá o token.
notifications
.channelName
string
Condicional
Nome do canal do Slack. Aceito apenas para SLACK notificações.
notifications
.delayMin
número
Condicional
Número de minutos de espera depois que uma condição de alerta é detectada antes que o MongoDB Ops Manager envie a primeira notificação.
notifications
.emailAddress
Condicional
Opcional
Endereço de e-mail para o qual enviar a notificação. Aceito apenas para EMAIL notificações.
notifications
.emailEnabled
booleano
Condicional
Alterne especificando se MongoDB Ops Manager envia notificações por e-mail. Aceito apenas para notificações GROUP e USER .
notifications
.intervalMin
número
Condicional
Número de minutos de espera entre notificações sucessivas para alertas não reconhecidos e não resolvidos que esta configuração de alerta Atlas Triggers.
notifications
.webhookSecret
string
Condicional

Um valor usado para autenticar com o webhook que aceita e encaminha a notificação. Você pode declarar explicitamente um segredo somente em uma solicitação que tenha ambos:

  • Um notifications.typeName de WEBHOOK

  • Uma declaração explicitamente notifications.webhookURL

Você pode configurar um webhookSecret para um webhookURL padrão somente com o Console do administrador.

Para declarar explicitamente um webhookURL sem um webhookSecret, omita este campo.

notifications
.webhookUrl
string
Opcional
URL do webhook que aciona esta notificação. Se você não declarar explicitamente um webhookUrl, sua solicitação usará o webhookUrl padrão definido no Admin Console.
notifications
.microsoftTeamsWebhookUrl
string
Condicional
URL do webhook de entrada do canal do Microsoft Teams. Aceito apenas para MICROSOFT_TEAMS notificações.
notifications
.notificationToken
string
Condicional
Token da API do HipChat. Aceito apenas para HIP_CHAT notificações. Se, posteriormente, o token se tornar inválido, o MongoDB Ops Manager enviará um e-mail ao proprietário do projeto e removerá o token.
notifications
.roomName
string
Condicional
Nome da sala do HipChat. Aceito apenas para HIP_CHAT notificações.
notifications
.serviceKey
string
Condicional

Chave de integração PagerDuty. Aceito apenas para PAGER_DUTY notificações. Se a chave posteriormente se tornar inválida, o MongoDB Ops Manager enviará um e-mail ao proprietário do projeto e removerá a chave.

PagerDuty descontinuado sua chave API REST v1 em outubro 2018. Se você tiver uma1 chave, poderá continuar a usar essa chave com o MongoDB Ops Manager. Todas as novas chaves PagerDuty usam sua REST API v2, mas MongoDB Ops Manager o não oferece suporte às2 chaves v . Se você não tiver a1 chave da API REST , use a API do PagerDuty Events v1 no lugar.

notifications
.smsEnabled
booleano
Condicional
Alterne a especificação se o MongoDB Ops Manager envia notificações por SMS. Aceito apenas para notificações GROUP e USER .
notifications
.snmpAddress
string
Condicional

Nome do host e porta para os quais enviar capturas SNMP. Neste momento, o MongoDB Ops Manager pode enviar capturas SNMP somente para a porta SNMP padrão (162). Aceito apenas para SNMP notificações.

Importante

MongoDB Ops Manager 6.0.0 descontinua alertas SNMP . MongoDB Ops Manager 7.0.0 não incluirá alertas de SNMP . Para saber mais sobre outras opções de alerta , consulte Integrações de serviços de terceiros.

Observação

MongoDB Ops Manager usa SNMP v2c.

notifications
.typeName
string
Obrigatório

Tipo de notificação de alerta que esta configuração de alerta Atlas Triggers. Os valores aceitos são:

  • ADMIN

  • GROUP

  • USER

  • SNMP

    Importante

    MongoDB Ops Manager 6.0.0 descontinua alertas SNMP . MongoDB Ops Manager 7.0.0 não incluirá alertas de SNMP . Para saber mais sobre outras opções de alerta , consulte Integrações de serviços de terceiros.

  • EMAIL

  • SMS (Disponível somente se o MongoDB Ops Manager estiver configurado para integração com o Twilio.)

  • HIPCHAT

  • SLACK

  • PAGER_DUTY

notifications
.username
string
Condicional
Nome do usuário do MongoDB Ops Manager para quem enviar notificações. Presente apenas para USER notificações.
threshold
objeto
Condicional

Limite que faz com que essa configuração de alerta trigger um alerta. Só é necessário se eventTypeName estiver definido para um dos seguintes valores:

  • TOO_FEW_HEALTHY_MEMBERS

  • TOO_MANY_UNHEALTHY_MEMBERS

threshold
.operator
string
Condicional

Operador para aplicar ao verificar o valor da métrica atual em relação a threshold.threshold. Os valores aceitos são:

  • GREATER_THAN

  • LESS_THAN

threshold
.threshold
número
Condicional
Valor limite fora do qual essa configuração de alerta Atlas Triggers um alerta.
tags
array de strings
Opcional
Tags associadas a esta configuração de alerta.
typeName
string
Opcional
Este campo é preterido e será ignorado.
Nome
Tipo
Descrição
created
string
Carimbo de data/hora na ISO 8601 formato de data e hora em UTC quando a configuração de alerta foi criada.
enabled
booleano
Alternar que especifica se a configuração de alerta está habilitada.
eventTypeName
string

Tipo de evento para o qual esta configuração de alerta Atlas Triggers um alerta.

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.

forAllGroups
booleano

Alternar que especifica se a configuração de alerta global se aplica a todos os grupos. Também afeta se você pode usar a array tags para direcionar a configuração para grupos específicos.

Se true, a configuração se aplica a todos os grupos. Você pode direcionar a configuração de alerta para grupos específicos através da matriz tags .

Se false, a configuração se aplica somente aos grupos especificados na array groupIds . Você deve especificar pelo menos um projeto na array groupIds . Você não pode usar a array tags para essa configuração de alerta.

groupIds
array de strings
IDs dos grupos aos quais essa configuração de alerta se aplica. Este campo se aplica somente se forAllGroups estiver definido como false.
id
string
Identificador único da configuração do alerta.
matchers
Array de objetos

Regras a serem aplicadas ao combinar um objeto com esta configuração de alerta global. MongoDB Ops Manager verifica apenas entidades que correspondem a todas essas regras para uma condição de alerta.

Você pode filtrar usando a array matchers somente quando o eventTypeName especifica um evento para um host, conjunto de réplicas ou cluster fragmentado.

matchers.fieldName
string

Nome do campo no objeto de destino ao qual corresponder.

  • Os alertas do host oferecem suporte aos seguintes campos:

    • HOSTNAME

    • PORT

    • HOSTNAME_AND_PORT

    • REPLICA_SET_NAME

    • TYPE_NAME

  • Os alertas de conjunto de réplicas suportam estes campos:

    • REPLICA_SET_NAME

    • SHARD_NAME

    • CLUSTER_NAME

  • Os alertas de cluster fragmentados suportam estes campos:

    • CLUSTER_NAME

    • SHARD_NAME

Todos os outros tipos de alertas não suportam correspondedores.

matchers.operator
string

Operador para testar o valor do campo. Os valores possíveis são:

  • EQUALS

  • NOT_EQUALS

  • CONTAINS

  • NOT_CONTAINS

  • STARTS_WITH

  • ENDS_WITH

  • REGEX

matchers.value
string

Valor para testar com o operador especificado.

Se matchers.fieldName estiver definido como TYPE_NAME, você poderá corresponder nos seguintes valores:

  • PRIMARY

  • SECONDARY

  • STANDALONE

  • CONFIG

  • MONGOS

metricThreshold
objeto
Limite que faz com que essa configuração de alerta trigger um alerta. Somente presente se eventTypeName estiver definido como OUTSIDE_METRIC_THRESHOLD.
metricThreshold.metricName
string
Nome da métrica a ser verificada. Suporta os mesmos valores que o campo metricName do recurso globalAlerts . Para obter uma lista de valores possíveis, consulte Tipos de medição para alertas globais.
metricThreshold.mode
string
É definido como AVERAGE e calcula o valor da métrica atual como uma média.
metricThreshold.operator
string

Operador para aplicar ao verificar o valor da métrica atual em relação a metricThreshold.threshold. Os valores possíveis são:

  • GREATER_THAN

  • LESS_THAN

metricThreshold.threshold
número
Valor limite fora do qual essa configuração de alerta Atlas Triggers um alerta.
metricThreshold.units
string

Unidades para metricThreshold.threshold. As unidades dependem do tipo de métrica.

Os valores aceitos são:

  • RAW

  • BITS

  • BYTES

  • KILOBITS

  • KILOBYTES

  • MEGABITS

  • MEGABYTES

  • GIGABITS

  • GIGABYTES

  • TERABYTES

  • PETABYTES

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

Por exemplo, uma métrica que mede o consumo de memória pode usar BYTES, enquanto uma métrica que mede o tempo pode usar HOURS.

notifications
Array de objetos
Notificações que o MongoDB Ops Manager envia quando detecta um alerta descrito por esta configuração de alerta.
notifications.apiToken
string

Token de API do Slack ou token de Bot. Presente apenas para SLACK notificações. Se, posteriormente, o token se tornar inválido, o MongoDB Ops Manager enviará um e-mail ao proprietário do projeto e removerá o token.

Depois de criar uma integração de terceiros que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:

  • Visualize ou edite o alerta por meio da UI.

  • Consulte as configurações de integração de terceiros por meio da API.

notifications.channelName
string
Nome do canal do Slack. Presente apenas para SLACK notificações.
notifications.delayMin
número
Número de minutos de espera depois que uma condição de alerta é detectada antes que o MongoDB Ops Manager envie a primeira notificação.
notifications.emailAddress
string
Endereço de e-mail para o qual enviar a notificação. Presente apenas para EMAIL notificações.
notifications.emailEnabled
booleano
Alterne especificando se MongoDB Ops Manager envia notificações por e-mail. Presente apenas para notificações GROUP e USER .
notifications.intervalMin
número
Número de minutos de espera entre notificações sucessivas para alertas não reconhecidos e não resolvidos que esta configuração de alerta Atlas Triggers.
notifications.[n]
.webhookSecret
string

Um valor usado para autenticar com o webhook que aceita e encaminha a notificação.

O Ops Manager retorna esse valor se você definir notifications.[n].typeName como WEBHOOK e se:

  • Você definiu notification.[n].webhookSecret como uma string não vazia

  • Você define um webhookSecret padrão no Console do administrador.

Depois de criar uma notificação de webhook, o URL é parcialmente redigido quando você visualiza ou edita o alerta, e o segredo é totalmente redigido.

notifications.[n]
.webhookUrl
string

URL do webhook que Atlas Triggers essa notificação.

O Ops Manager retorna esse valor se você definir notifications.[n].typeName como WEBHOOK e se:

  • Você definiu notification.[n].webhookURL como uma string não vazia

  • Você define um webhookUrl padrão na página Console do administrador.

Depois de criar uma notificação de webhook, o URL é parcialmente redigido quando você visualiza ou edita o alerta, e o segredo é totalmente redigido.

notifications.microsoftTeamsWebhookUrl
string

URL do webhook de entrada do canal do Microsoft Teams. Presente apenas para MICROSOFT_TEAMS notificações.

Quando você exibe ou edita o alerta de uma notificação de webhook, o URL aparece parcialmente redigido, e o segredo aparece completamente redigido.

notifications.notificationToken
string

Token da API do HipChat. Presente apenas para HIP_CHAT notificações. Se, posteriormente, o token se tornar inválido, o MongoDB Ops Manager enviará um e-mail ao proprietário do projeto e removerá o token.

Depois de criar uma integração de terceiros que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:

  • Visualize ou edite o alerta por meio da UI.

  • Consulte as configurações de integração de terceiros por meio da API.

notifications.roomName
string
Nome da sala do HipChat. Presente apenas para HIP_CHAT notificações.
notifications.serviceKey
string

Chave de integração PagerDuty. Presente apenas para PAGER_DUTY notificações. Se a chave posteriormente se tornar inválida, o MongoDB Ops Manager enviará um e-mail ao proprietário do projeto e removerá a chave.

Depois de criar uma integração de terceiros que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:

  • Visualize ou edite o alerta por meio da UI.

  • Consulte as configurações de integração de terceiros por meio da API.

notifications.smsEnabled
booleano
Alterne a especificação se o MongoDB Ops Manager envia notificações por SMS. Presente apenas para notificações GROUP e USER .
notifications.snmpAddress
string

Nome do host e porta para os quais enviar capturas SNMP. Neste momento, o MongoDB Ops Manager pode enviar capturas SNMP somente para a porta SNMP padrão (162). Presente apenas para SNMP notificações.

Importante

MongoDB Ops Manager 6.0.0 descontinua alertas SNMP . MongoDB Ops Manager 7.0.0 não incluirá alertas de SNMP . Para saber mais sobre outras opções de alerta , consulte Integrações de serviços de terceiros.

Observação

MongoDB Ops Manager usa SNMP v2c.

notifications.typeName
string

Tipo de notificação de alerta que esta configuração de alerta Atlas Triggers. Os valores possíveis são:

  • ADMIN

  • GROUP

  • USER

  • SNMP

    Importante

    MongoDB Ops Manager 6.0.0 descontinua alertas SNMP . MongoDB Ops Manager 7.0.0 não incluirá alertas de SNMP . Para saber mais sobre outras opções de alerta , consulte Integrações de serviços de terceiros.

  • EMAIL

  • SMS (Disponível somente se o MongoDB Ops Manager estiver configurado para integração com o Twilio.)

  • HIPCHAT

  • SLACK

  • PAGER_DUTY

notifications.username
string
Nome do usuário do MongoDB Ops Manager para quem enviar notificações. Presente apenas para USER notificações.
threshold
objeto

Limite que faz com que essa configuração de alerta trigger um alerta. Somente presente se eventTypeName estiver definido para um dos seguintes valores:

  • TOO_FEW_HEALTHY_MEMBERS

  • TOO_MANY_UNHEALTHY_MEMBERS

threshold.operator
string

Operador para aplicar ao verificar o valor da métrica atual em relação a threshold.threshold. Os valores possíveis são:

  • GREATER_THAN

  • LESS_THAN

threshold.threshold
número
Valor limite fora do qual essa configuração de alerta Atlas Triggers um alerta.
tags
array de strings
Tags associadas a esta configuração de alerta.
typeName
string
Este campo é preterido e será ignorado.
updated
string
Carimbo de data/hora na ISO 8601 formato de data e hora em UTC quando esta configuração de alerta foi atualizada pela última vez.
1curl --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/globalAlertConfigs \
6 --data '{
7 "enabled": true,
8 "eventTypeName": "BACKUP_AGENT_DOWN",
9 "forAllGroups": true,
10 "groupIds": [],
11 "matchers": [],
12 "notifications": [
13 {
14 "delayMin": 0,
15 "intervalMin": 60,
16 "typeName": "ADMIN"
17 }
18 ],
19 "tags": [],
20 "typeName": "AGENT"
21 }
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}
1{
2 "created": "2019-10-02T12:34:04Z",
3 "enabled": true,
4 "eventTypeName": "BACKUP_AGENT_DOWN",
5 "forAllGroups": true,
6 "groupIds": [],
7 "id": "{GLOBAL-ALERT-CONFIG-ID}",
8 "links": [
9 ],
10 "matchers": [],
11 "notifications": [
12 {
13 "delayMin": 0,
14 "intervalMin": 60,
15 "typeName": "ADMIN"
16 }
17 ],
18 "tags": [],
19 "typeName": "AGENT",
20 "updated": "2019-10-02T12:34:04Z"
21}

Voltar

Obter uma configuração de alerta global