Atualizar uma configuração de alerta global
Nesta página
Atualize uma configuração de alerta global identificada por seu GLOBAL-ALERT-CONFIG-ID
.
Funções obrigatórias
Você pode chamar esse endpoint com sucesso com qualquer um dos seguintes roles atribuídos:
Solicitar
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
PUT /globalAlertConfigs/{GLOBAL-ALERT-CONFIG-ID}
Parâmetros do caminho da solicitação
Nome | Tipo | necessidade | Descrição |
---|---|---|---|
{GLOBAL-ALERT-CONFIG-ID} | string | Obrigatório | Identificador exclusivo da configuração de alerta global que você deseja atualizar. |
Solicitar parâmetros de query
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:
| false |
Parâmetros do corpo da solicitação
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 Se Se |
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 .fieldName | string | Condicional | Nome do campo no objeto de destino ao qual corresponder.
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:
|
matchers .value | string | Condicional | Valor para testar com o operador especificado. Se
|
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 | número | Condicional | Valor limite fora do qual essa configuração de alerta Atlas Triggers um alerta. |
metricThreshold .units | string | Condicional | Unidades para Os valores aceitos são:
Por exemplo, uma métrica que mede o consumo de memória pode usar |
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:
Você pode configurar um Para declarar explicitamente um |
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 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 ImportanteMongoDB 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çãoMongoDB 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:
|
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
|
threshold .operator | string | Condicional | Operador para aplicar ao verificar o valor da métrica atual em relação a
|
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. |
Resposta
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 Se Se |
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.fieldName | string | Nome do campo no objeto de destino ao qual corresponder.
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:
|
matchers.value | string | Valor para testar com o operador especificado. Se
|
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 | número | Valor limite fora do qual essa configuração de alerta Atlas Triggers um alerta. |
metricThreshold.units | string | Unidades para Os valores aceitos são:
Por exemplo, uma métrica que mede o consumo de memória pode usar |
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 Depois de criar uma integração de terceiros que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:
|
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
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
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 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 Depois de criar uma integração de terceiros que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:
|
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 Depois de criar uma integração de terceiros que requer uma API ou chave de integração, a chave aparece parcialmente oculta quando você:
|
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 ImportanteMongoDB 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çãoMongoDB 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:
|
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
|
threshold.operator | string | Operador para aplicar ao verificar o valor da métrica atual em relação a
|
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. |
Exemplo de solicitação
1 curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ 2 --header "Accept: application/json" \ 3 --header "Content-Type: application/json" \ 4 --include \ 5 --request PUT "https://<OpsManagerHost>:<Port>/api/public/v1.0/globalAlertConfigs/{GLOBAL-ALERT-CONFIG-ID}" \ 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 }
Exemplo de resposta
Cabeçalho de resposta
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
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 "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 }