Get All Global Alert Configurations
On this page
Retrieve all global alert configurations.
Required Roles
You can successfully call this endpoint with any of the following assigned roles:
Request
Base URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
GET /globalAlertConfigs
Request Path Parameters
This endpoint doesn't use HTTP request body parameters.
Request Query Parameters
Name | Type | Necessity | Description | Default |
---|---|---|---|---|
pageNum | number | Optional | One-based integer that returns a subsection of results. | 1 |
itemsPerPage | number | Optional | Number of items to return per page, up to a maximum of 500. | 100 |
pretty | boolean | Optional | Flag that indicates whether the response body should be in a
prettyprint format. | false |
envelope | boolean | Optional | Flag that indicates whether or not to wrap the response in an envelope. Some API clients cannot access the HTTP response headers or
status code. To remediate this, set For endpoints that return a list of results, the | false |
Request Body Parameters
This endpoint doesn't use HTTP request body parameters.
Response
Response Document
The response JSON document includes an array of result objects, an array of link objects and a count of the total number of result objects retrieved.
Name | Type | Description |
---|---|---|
results | array | Array includes one object for each item detailed in the
results Embedded Document section. |
links | array | Array includes one or more links to sub-resources
and/or related resources. The relations between URLs are
explained in the Web Linking Specification. |
totalCount | number | Integer count of the total number of items in the result set. It
may be greater than the number of objects in the
results array if the entire result set is paginated. |
results
Embedded Document
Each result is one alert configuration.
Name | Type | Description |
---|---|---|
created | string | Timestamp in ISO 8601 date and time format in UTC when the alert configuration was created. |
enabled | boolean | Toggle that specifies whether the alert configuration is enabled. |
eventTypeName | string | Type of event for which this alert configuration triggers an alert. To review the types of events that generate alerts, see Alert Types. For a complete list of events included in the Ops Manager audit log, see Audit Events. |
forAllGroups | boolean | Toggle that specifies whether the global alert configuration
applies to all groups. Also affects whether you can use the
If If |
groupIds | array of strings | IDs of the groups to which this alert configuration applies.
This field applies only if forAllGroups is set to false . |
id | string | Unique identifier of the alert configuration. |
matchers | array of objects | Rules to apply when matching an object against this global alert configuration. Ops Manager only checks entities that match all these rules for an alert condition. You can filter using the |
matchers.fieldName | string | Name of the field in the target object on which to match.
All other types of alerts do not support matchers. |
matchers.operator | string | Operator to test the field's value. Possible values are:
|
matchers.value | string | Value to test with the specified operator. If
|
metricThreshold | object | Threshold that causes this alert configuration to trigger
an alert. Only present if eventTypeName is set to
OUTSIDE_METRIC_THRESHOLD . |
metricThreshold.metricName | string | Name of the metric to check. Supports the same values as the
metricName field of the globalAlerts resource. For a list
of possible values, see
Measurement Types for Global Alerts. |
metricThreshold.mode | string | This is set to AVERAGE and computes the current metric value
as an average. |
metricThreshold.operator | string | Operator to apply when checking the current metric value
against
|
metricThreshold.threshold | number | Threshold value outside of which this alert configuration
triggers an alert. |
metricThreshold.units | string | Units for Accepted values are:
For example, a metric that measures memory consumption can use |
notifications | array of objects | Notifications Ops Manager sends when it detects an alert that this
alert configuration describes. |
notifications.apiToken | string | Slack API token or Bot token. Only present for After you create a third-party integration that requires an API or integration key, the key appears partially redacted when you:
|
notifications.channelName | string | Slack channel name. Only present for SLACK notifications. |
notifications.delayMin | number | Number of minutes to wait after an alert condition is
detected before Ops Manager sends out the first notification. |
notifications.emailAddress | string | Email address to which to send notification. Only present for
EMAIL notifications. |
notifications.emailEnabled | boolean | Toggle specifying whether Ops Manager sends email notifications.
Only present for GROUP and USER notifications. |
notifications.intervalMin | number | Number of minutes to wait between successive notifications
for unacknowledged, unresolved alerts that this alert
configuration triggers. |
notifications.[n] .webhookSecret | string | A value used to authenticate with the Webhook that accepts and forwards the notification. Ops Manager returns this value if you set
After creating a webhook notification, the URL is partially redacted when you view or edit the alert, and the secret is completely redacted. |
notifications.[n] .webhookUrl | string | URL for the webhook that triggers this notification. Ops Manager returns this value if you set
After creating a webhook notification, the URL is partially redacted when you view or edit the alert, and the secret is completely redacted. |
notifications.microsoftTeamsWebhookUrl | string | Microsoft Teams channel incoming webhook URL. Only present
for When you view or edit the alert for a webhook notification, the URL appears partially redacted, and the secret appears completely redacted. |
notifications.notificationToken | string | HipChat API token. Only present for After you create a third-party integration that requires an API or integration key, the key appears partially redacted when you:
|
notifications.roomName | string | HipChat room name. Only present for HIP_CHAT notifications. |
notifications.serviceKey | string | PagerDuty integration key. Only present for After you create a third-party integration that requires an API or integration key, the key appears partially redacted when you:
|
notifications.smsEnabled | boolean | Toggle specifying whether Ops Manager sends SMS notifications. Only
present for GROUP and USER notifications. |
notifications.typeName | string | Type of alert notification this alert configuration triggers. Possible values are:
|
notifications.username | string | Name of the Ops Manager user to whom to send notifications. Only
present for USER notifications. |
threshold | object | Threshold that causes this alert configuration to trigger
an alert. Only present if
|
threshold.operator | string | Operator to apply when checking the current metric value against
|
threshold.threshold | number | Threshold value outside of which this alert configuration
triggers an alert. |
tags | array of strings | Tags associated with this alert configuration. |
typeName | string | This field is deprecated and will be ignored. |
updated | string | Timestamp in ISO 8601 date and time format in UTC when this alert configuration was last updated. |
Example Request
1 curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ 2 --header "Accept: application/json" \ 3 --include \ 4 --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/globalAlertConfigs"
Example Response
Response Header
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}
Response Body
1 { 2 "links": [ 3 ], 4 "results": [ 5 { 6 "created": "2019-10-02T12:34:04Z", 7 "enabled": true, 8 "eventTypeName": "RS_BIND_ERROR", 9 "forAllGroups": true, 10 "groupIds": [], 11 "id": "{GLOBAL-ALERT-CONFIG-ID}", 12 "links": [ 13 ], 14 "matchers": [], 15 "notifications": [ 16 { 17 "delayMin": 0, 18 "intervalMin": 60, 19 "typeName": "ADMIN" 20 } 21 ], 22 "tags": [], 23 "typeName": "BACKUP", 24 "updated": "2019-10-02T12:34:04Z" 25 }, 26 { 27 "created": "2019-10-02T12:34:04Z", 28 "enabled": true, 29 "eventTypeName": "BACKUP_TOO_MANY_RETRIES", 30 "forAllGroups": true, 31 "groupIds": [], 32 "id": "{GLOBAL-ALERT-CONFIG-ID}", 33 "links": [ 34 ], 35 "matchers": [], 36 "notifications": [ 37 { 38 "delayMin": 0, 39 "intervalMin": 60, 40 "typeName": "ADMIN" 41 } 42 ], 43 "tags": [], 44 "typeName": "BACKUP", 45 "updated": "2019-10-02T12:34:04Z" 46 }, 47 { 48 "created": "2019-10-02T12:34:04Z", 49 "enabled": true, 50 "eventTypeName": "BACKUP_IN_UNEXPECTED_STATE", 51 "forAllGroups": true, 52 "groupIds": [], 53 "id": "{GLOBAL-ALERT-CONFIG-ID}", 54 "links": [ 55 ], 56 "matchers": [], 57 "notifications": [ 58 { 59 "delayMin": 0, 60 "intervalMin": 60, 61 "typeName": "ADMIN" 62 } 63 ], 64 "tags": [], 65 "typeName": "BACKUP", 66 "updated": "2019-10-02T12:34:04Z" 67 } 68 ], 69 "totalCount": 3 70 }