Get Open Alerts for Alert Configuration
On this page
Note
Groups and projects are synonymous terms. Your {PROJECT-ID}
is the
same as your project id. For existing groups, your group/project id
remains the same. This page uses the more familiar term group when
referring to descriptions. The endpoint remains as stated in the
document.
Base URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
GET /groups/{PROJECT-ID}/alertConfigs/{ALERT-CONFIG-ID}/alerts
Request Path Parameters
All request path parameters are required.
Parameter | Type | Description |
---|---|---|
PROJECT-ID | string | Unique identifier for this Project. |
ALERT-CONFIG-ID | string | Unique identifier for this alert configuration. |
Request Query Parameters
The following query parameters are optional:
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 |
backupJobsEnabledOnly | boolean | Optional | Flag indicating whether to exclude daemons not enabled for
backing up databases from the response. Set this to false to
include daemon configurations with the backupJobsEnabled
flag set to false . | true |
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.
Note
Alert details vary. An alert may only include a subset of these elements.
Name | Type | Description |
---|---|---|
acknowledgedUntil | string | Timestamp in ISO 8601 date and time format in UTC when through which the alert has been
acknowledged. Populated if the alert has been acknowledged. |
acknowledgingUsername | string | Username of the user who acknowledged the alert. Populated if
the alert has been acknowledged. |
acknowledgementComment | string | Comment user who acknowledged the alert left. Populated
if the alert has been acknowledged. |
alertConfigId | string | Unique identifier of the alert configuration that triggered
this alert. |
clusterId | string | Unique identifier of the cluster to which this alert applies.
Populated for BACKUP , REPLICA_SET , and CLUSTER
alerts. |
clusterName | string | Name the cluster to which this alert applies.
Populated for BACKUP , REPLICA_SET , and CLUSTER
alerts. |
created | string | Timestamp in ISO 8601 date and time format in UTC when the alert was opened. |
currentValue | object | Current value of the metric that triggered the alert. Populated
for HOST_METRIC alerts. |
currentValue.number | number | Value of the metric. |
currentValue.units | string | Units for the value. Depends on the type of metric. For example, a metric that measures memory consumption would have a byte measurement, while a metric that measures time would have a time unit. Accepted values are:
|
eventTypeName | string | Name of the event that triggered the alert. Values include: Agent Automation Configuration Backup BI Connector Cluster Data Explorer Accessed Host Organization Project Replica Set Team User To review the full list of events that generate alerts and their descriptions, see Alert Types. For a complete list of events included in the Ops Manager audit log, see Audit Events. |
groupId | string | Unique identifier of the project that this alert was opened for. |
hostId | string | Unique identifier of the host to which the metric pertains.
Populated for HOST , HOST_METRIC , and REPLICA_SET
alerts. |
hostnameAndPort | string | Hostname and port of each host to which the alert applies.
Populated for HOST , HOST_METRIC , and REPLICA_SET
alerts. |
id | string | Unique identifier for the alert. |
lastNotified | string | Timestamp in ISO 8601 date and time format in UTC when the last notification was sent for this
alert. Populated if notifications have been sent. |
metricName | string | Name of the measurement whose value went outside the threshold.
Populated if For accepted values, see Measurement Types for Alerts on this page. |
replicaSetName | string | Name of the replica set.
Populated for HOST , HOST_METRIC , BACKUP , and
REPLICA_SET alerts. |
resolved | string | Timestamp in ISO 8601 date and time format in UTC when the alert was closed. Populated if
"status" : "CLOSED" . |
sourceTypeName | string | For
|
status | string | Current state of the alert. Accepted values are:
|
typeName | string | This field is deprecated and will be ignored. |
updated | string | Timestamp in ISO 8601 date and time format in UTC when the alert was last updated. |
Example Request
curl --user '{PUBLIC-KEY}:{PRIVATE-KEY}' --digest \ --header 'Accept: application/json' \ --include \ --request GET "https://<ops-manager-host>/api/public/v1.0/groups/{PROJECT-ID}/alertConfigs/{ALERT-CONFIG-ID}/alerts"
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
{ "links" : [], "results" : [ { "acknowledgedUntil" : "2014-05-01T14:00:00Z", "alertConfigId":"{ALERT-CONFIG-ID}", "created" : "2014-04-22T15:57:13.562Z", "currentValue" : { "number" : 0.0, "units" : "RAW" }, "eventTypeName" : "OUTSIDE_METRIC_THRESHOLD", "groupId" : "{PROJECT-ID}", "id" : "53569159300495c7702ee3a3", "lastNotified" : "2014-04-22T15:57:24.126Z", "links" : [], "metricName" : "ASSERT_REGULAR", "status" : "OPEN", "updated" : "2014-04-22T20:14:11.388Z" }, { "alertConfigId":"{ALERT-CONFIG-ID}", "created" : "2014-04-22T19:59:10.657Z", "currentValue" : { "number" : 0.0, "units" : "RAW" }, "eventTypeName" : "OUTSIDE_METRIC_THRESHOLD", "groupId" : "{PROJECT-ID}", "id" : "5356ca0e300495c770333340", "lastNotified" : "2014-04-22T20:14:19.313Z", "links" : [], "metricName" : "ASSERT_REGULAR", "status" : "OPEN", "updated" : "2014-04-22T20:14:11.388Z" } ], "totalCount" : 2 }