Nota
Grupos y proyectos son términos sinónimos. Tu {PROJECT-ID} es lo mismo que tu ID del grupo. Para los grupos existentes, su identificador de grupo/proyecto sigue siendo el mismo. Esta página utiliza el término más familiar "grupo" al referirse a descripciones. El endpoint permanece como se indica en el documento.
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
POST /groups/{PROJECT-ID}/alertConfigs
Parámetros de ruta de solicitud
Todos los parámetros de ruta de solicitud son obligatorios.
Parameter | Tipo | Descripción |
|---|---|---|
PROJECT-ID | string | Identificador único para este proyecto. |
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. |
| ||||||
envelope | booleano | Opcional | Bandera que indica si se debe o no envolver la respuesta en un sobre. Algunos Los clientes API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar este problema, configure envelope=true en la query. Para los endpoints que devuelven un resultado, el cuerpo de la respuesta incluye:
|
|
Parámetros del cuerpo de la solicitud
Nota
Las configuraciones de alertas varían. Una configuración de alerta solo puede incluir un subconjunto de estos elementos.
Nombre | Tipo | Necesidad | Descripción |
|---|---|---|---|
habilitado | booleano | Opcional | Si se omite, la configuración se desactivará. |
eventTypeName | string | Requerido | El tipo de evento que activa una alerta. Los valores incluyen: agente Configuración de automatización Backup Conector de BI clúster Explorador de datos accedido host organización Proyecto Set de réplicas equipo Usuario Para revisar la lista completa de eventos que generan alertas y sus descripciones, consulta Tipos de Alertas. Para obtener una lista completa de los eventos incluidos en el registro de auditoría de Ops Manager, consulta Eventos de auditoría. |
matchers .fieldName | string | Opcional | Nombre del campo en el objeto de destino con el que hacer coincidir.
Todos los demás tipos de alertas no soportan matchers. |
matchers .operator | string | Opcional | Operador para probar el valor del campo. Los valores aceptados son:
|
matchers .value | string | Opcional | Valor a probar con el operador especificado. Si
|
comparadores | objeto arreglo | Opcional | Reglas a aplicar al cotejar un objeto con esta configuración de alerta. Solo las entidades que cumplen todas estas reglas son revisadas por una condición de alerta. Puede filtrar utilizando solo el arreglo |
metricThreshold .metricName | string | Opcional | Nombre de la métrica a comprobar. Admite los mismos valores que el campo |
metricThreshold .mode | string | Opcional | Configura en |
metricThreshold .operator | string | Opcional | Operador a aplicar al verificar el valor actual de la métrica frente al valor umbral. Los valores aceptados son:
|
metricThreshold .threshold | Número | Opcional | Valor umbral fuera del cual se activa una alerta. |
metricThreshold .units | string | Opcional | Unidades para el valor umbral. Depende del tipo de métrica. Por ejemplo, una métrica que mide el consumo de memoria tendría una medida en bytes, mientras que una métrica que mide el tiempo tendría una unidad de tiempo. Los valores aceptados son:
|
metricThreshold | Objeto | Condicional | Umbral que provocará la activación de una alerta. Obligatorio si |
notifications .apiToken | string | Condicional | Token de API de Slack o token de Bot. Requerido si Después de crear una integración de terceros que requiere una API o una clave de integración, la clave aparece parcialmente redactada cuando:
|
notifications .channelName | string | Condicional | Nombre del canal de Slack. Obligatorio si |
notifications .datadogApiKey | string | Condicional | Clave de API de DataDog. Encontrado en el tablero de DataDog. Requerido si Después de crear una integración de terceros que requiere una API o una clave de integración, la clave aparece parcialmente redactada cuando:
|
notifications .delayMin | Número | Opcional | Número de minutos de espera tras detectarse una condición de alerta antes de enviar la primera notificación. |
notifications .emailAddress | string | Condicional | Dirección de correo electrónico a la que enviar la notificación. Obligatorio si |
notifications .emailEnabled | booleano | Condicional | Determina si se deben enviar notificaciones por correo electrónico. Requerido si:
|
notifications .intervalMin | Número | Opcional | Número de minutos que deben transcurrir entre notificaciones sucesivas sobre alertas no reconocidas que no se hayan resuelto. |
notifications .webhookSecret | string | Opcional | Un valor usado para autenticarse con el Webhook que acepta y reenvía la notificación. Puedes declarar explícitamente un secreto únicamente en una solicitud que tenga ambas condiciones:
Puede configurar un Para declarar explícitamente un Después de crear una notificación de webhook, la URL está parcialmente redactada cuando ves o editas la alerta, y el secreto está completamente redactado. |
notifications .webhookUrl | string | Opcional | URL para el webhook que activa esta notificación. Si no declaras explícitamente un Después de crear una notificación de webhook, la URL está parcialmente redactada cuando ves o editas la alerta, y el secreto está completamente redactado. |
notifications .webhookHeadersTemplate | string | Opcional | Plantilla para encabezados personalizados para incluir en las notificaciones webhook. Puedes usar variables en la plantilla que se reemplazan con valores específicos de la alerta cuando se envía la notificación. |
notifications .webhookBodyTemplate | string | Opcional | Plantilla para el contenido del cuerpo de las notificaciones de webhook. Puedes usar variables en la plantilla que se reemplazan con valores específicos de la alerta cuando se envía la notificación. |
notifications .microsoftTeamsWebhookUrl | string | Condicional | URL del webhook entrante del canal de Microsoft Teams. Requerido si Cuando se ve o edita la alerta de una notificación de webhook, la URL aparece parcialmente oculta y el secreto aparece completamente oculto. |
notifications .mobileNumber | string | Condicional | Número de móvil al que se enviarán mensajes SMS. Obligatorio si |
notifications .notificationToken | string | Condicional | Un token de API de HipChat. Obligatorio si Después de crear una integración de terceros que requiere una API o una clave de integración, la clave aparece parcialmente redactada cuando:
|
notifications .role | string | Condicional | Rol de Ops Manager en el proyecto actual. Obligatorio si |
notifications .roomName | string | Condicional | Nombre de la sala de HipChat. Obligatorio si |
notifications .serviceKey | string | Condicional | Clave de integración PagerDuty. Requerido si Después de crear una integración de terceros que requiere una API o una clave de integración, la clave aparece parcialmente redactada cuando:
|
notifications .smsEnabled | booleano | Condicional | Indica que se deben enviar notificaciones por SMS. Obligatorio si:
|
notifications .teamId | string | Opcional | Identificador único de un equipo. |
notifications .typeName | string | Opcional | Tipo de notificación de alerta. Los valores aceptados son:
|
notifications .username | string | Condicional | Nombre de un usuario de Ops Manager al que enviar notificaciones. Especifique un usuario en el Proyecto que posea la configuración de alertas. Requerido si |
notificaciones | objeto arreglo | Requerido | Notificaciones para enviar cuando se detecta una condición de alerta. |
threshold .operator | string | Opcional | Operador que se aplica al comparar el valor de la métrica actual con el valor umbral.
|
threshold .threshold | Número | Opcional | Valor umbral fuera del cual se activa una alerta. |
umbral | Objeto | Condicional | Umbral que provocará la activación de una alerta. Obligatorio si:
|
Respuesta
La respuesta incluye los detalles de la configuración de la alerta:
Nota
Las configuraciones de alertas varían. Una configuración de alerta solo puede incluir un subconjunto de estos elementos.
Nombre | Tipo | Descripción |
|---|---|---|
creado | string | Marca temporal en ISO 8601 fecha y formato de hora en UTC cuando esta configuración de alerta fue creada. |
habilitado | booleano | Indicador de que esta configuración de alerta está habilitada. |
eventTypeName | string | Tipo de evento que activa una alerta. |
ID del grupo | string | Identificador único del Proyecto que posee esta configuración de alerta. |
ID | string | Identificador único de la configuración de la alerta. |
enlaces | Arreglo de objetos | Uno o más enlaces a sub-recursos y/o recursos relacionados. Los tipos de relación entre URLs se explican en la Especificación de Vinculación Web. |
comparadores | Arreglo de objetos | Reglas para aplicar al comparar un objeto con esta configuración de alerta. |
matchers .[n].fieldName | string | Nombre del campo en el objeto de destino que deseas que esta configuración coincida. |
matchers .[n].operator | string | Operador de comparación para aplicar al verificar el valor actual de la métrica con respecto a |
matchers .[n].value | string | Valor para igualar o superar usando |
metricThreshold | Objeto | Valor y medio de comparación que activa una alerta. |
metricThreshold .metricName | string | Nombre de la métrica a comprobar. Admite los mismos valores que el campo |
metricThreshold .mode | string | Valor promedio de esta métrica. |
metricThreshold .operator | string | Operador de comparación que Ops Manager aplicó al verificar el valor métrico actual contra el valor umbral. |
metricThreshold .threshold | Número | Valor de |
metricThreshold .units | string | Unidades de capacidad o tiempo que definen el alcance del |
notificaciones | Arreglo de objetos | Uno o más destinos para que Ops Manager envíe notificaciones cuando se detecta una condición de alerta. |
notifications.[n] .apiToken | string | Token token de API de Slack. Ops Manager devuelve este valor si se configura Después de crear una integración de terceros que requiere una API o una clave de integración, la clave aparece parcialmente redactada cuando:
|
notifications.[n] .channelName | string | Nombre del canal de Slack. Ops Manager devuelve este valor si estableces |
notifications.[n] .datadogApiKey | string | Clave de API de DataDog. Ops Manager devuelve este valor si estableces Después de crear una integración de terceros que requiere una API o una clave de integración, la clave aparece parcialmente redactada cuando:
|
notifications.[n] .delayMin | Número | Número de minutos de espera tras detectarse una condición de alerta antes de enviar la primera notificación. |
notifications.[n] .emailAddress | string | Dirección de correo electrónico a la que enviar la notificación. Ops Manager devuelve este valor si estableces |
notifications.[n] .emailEnabled | booleano | Bandera que indica que se deben enviar notificaciones por correo electrónico. Ops Manager devuelve este valor si estableces |
notifications.[n] .intervalMin | Número | Número de minutos que deben transcurrir entre notificaciones sucesivas sobre alertas no reconocidas que no se hayan resuelto. |
notifications.[n] .microsoftTeamsWebhookUrl | string | URL del webhook entrante del canal de Microsoft Teams. Ops Manager devuelve este valor si estableces Cuando se ve o edita la alerta de una notificación de webhook, la URL aparece parcialmente oculta y el secreto aparece completamente oculto. |
notifications.[n] .mobileNumber | string | Número de teléfono móvil al que se envían las notificaciones de alerta. Ops Manager devuelve este valor si estableces |
notifications.[n] .notificationToken | string | Token de la API de HipChat. Ops Manager devuelve este valor si estableces Si el token se vuelve inválido más adelante, MongoDB Atlas enviará un correo electrónico a Después de crear una integración de terceros que requiere una API o una clave de integración, la clave aparece parcialmente redactada cuando:
|
notifications.[n] .opsGenieApiKey | string | API de alertas de OpsGenie clave. Ops Manager devuelve este valor si se establece Después de crear una integración de terceros que requiere una API o una clave de integración, la clave aparece parcialmente redactada cuando:
|
notifications.[n] .opsGenieRegion | string | Región que indica qué API URL utilizar. Ops Manager devuelve este valor si se establece |
notifications.[n] .roles | Arreglo de cadenas | Rol de Ops Manager en el Proyecto u organización actuales. Ops Manager devuelve este valor si establece |
notifications.[n] .roomName | string | Nombre de la sala de HipChat. Ops Manager devuelve este valor si |
notifications.[n] .serviceKey | string | Clave de servicio de PagerDuty. Ops Manager devuelve este valor si estableces Después de crear una integración de terceros que requiere una API o una clave de integración, la clave aparece parcialmente redactada cuando:
|
notifications.[n] .smsEnabled | booleano | Bandera que indica que se deben enviar notificaciones de texto. Ops Manager devuelve este valor si se configura |
notifications.[n] .teamId | string | Identificador único del equipo que recibe esta notificación. |
notifications.[n] .teamName | string | Etiqueta para el equipo que recibe esta notificación. |
notifications.[n] .typeName | string | Medios por los cuales desea que Ops Manager le envíe una notificación de una alerta. |
notifications.[n] .username | string | Nombre de un usuario de Ops Manager al que enviar notificaciones. Ops Manager devuelve este valor si se configura |
notifications.[n] .victorOpsApiKey | string | VictorOps API key. Si la clave se vuelve inválida, MongoDB Atlas envía un correo electrónico al Ops Manager devuelve este valor si estableces Después de crear una integración de terceros que requiere una API o una clave de integración, la clave aparece parcialmente redactada cuando:
|
notifications.[n] .victorOpsRoutingKey | string | Clave de enrutamiento de VictorOps. Si la clave se vuelve inválida, MongoDB Atlas envía un correo electrónico al Ops Manager devuelve este valor si estableces |
notifications.[n] .webhookSecret | string | Un valor utilizado para autenticar con el Webhook que acepta y reenvía la notificación. Ops Manager devuelve este valor si configuras
Después de crear una notificación de webhook, la URL está parcialmente redactada cuando ves o editas la alerta, y el secreto está completamente redactado. |
notifications.[n] .webhookUrl | string | URL del webhook que activa esta notificación. Ops Manager devuelve este valor si configuras
Después de crear una notificación de webhook, la URL está parcialmente redactada cuando ves o editas la alerta, y el secreto está completamente redactado. |
notifications.[n] .webhookHeadersTemplate | string | Plantilla para encabezados personalizados que se incluirán en las notificaciones webhook. El Gestor de Operaciones devuelve este valor si configuras |
notifications.[n] .webhookBodyTemplate | string | Plantilla para el contenido del cuerpo de las notificaciones de webhook. El Administrador de operaciones devuelve este valor si se establece |
notifications.[n] .id | string | Identificador único de la configuración de notificación. |
umbral | Objeto | Umbral que activa una alerta. Ops Manager devuelve este valor si |
threshold .operator | string | Operador de comparación que Ops Manager aplicó al verificar el valor métrico actual contra el valor umbral. |
threshold .threshold | Número | Valor que, cuando se excede, Ops Manager activa una alerta. |
threshold .units | string | Unidades de capacidad o tiempo que definen el alcance del |
typeName | string | Este campo está obsoleto y se ignora. |
actualizado | string | Marca de tiempo en ISO 8601 formato de fecha y hora en UTC cuando esta configuración de alerta se actualizó por última vez. |
Solicitud de ejemplo
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --include \ --request POST "https://<ops-manager-host>/api/public/v1.0/groups/{PROJECT-ID}/alertConfigs" \ --data ' { "eventTypeName" : "RESYNC_REQUIRED", "enabled" : true, "notifications" : [ { "typeName" : "GROUP", "intervalMin" : 5, "delayMin" : 0, "smsEnabled" : false, "emailEnabled" : true }, { "typeName" : "WEBHOOK", "intervalMin" : 5, "delayMin" : 0, "webhookUrl" : "https://example.com/webhook", "webhookSecret" : "secret123", "webhookHeadersTemplate" : "{\"X-Alert-Type\": \"{{eventTypeName}}\"}", "webhookBodyTemplate" : "{\"alert\": \"{{eventTypeName}}\", \"project\": \"{{groupName}}\"}" } ] }'
Respuesta de ejemplo
Encabezado de respuesta
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}
Respuesta del cuerpo
{ "created" : "2014-04-23T14:29:18Z", "enabled" : true, "groupId" : "{PROJECT-ID}", "id" : "{ALERT-CONFIG-ID}", "links" : [], "matchers" : [ ], "notifications" : [ { "id" : "{NOTIFICATION-ID-1}", "delayMin" : 0, "emailEnabled" : true, "intervalMin" : 5, "smsEnabled" : false, "typeName" : "GROUP" }, { "id" : "{NOTIFICATION-ID-2}", "delayMin" : 0, "intervalMin" : 5, "typeName" : "WEBHOOK", "webhookUrl" : "https://example.com/webhook", "webhookSecret" : "***", "webhookHeadersTemplate" : "{\"X-Alert-Type\": \"{{eventTypeName}}\"}", "webhookBodyTemplate" : "{\"alert\": \"{{eventTypeName}}\", \"project\": \"{{groupName}}\"}" } ], "updated" : "2014-04-23T14:29:18Z" }