Get an Alert
On this page
Groups and projects are synonymous terms. Your {GROUP-ID} is the
same as your project ID. For existing groups, your group/project ID
remains the same. The resource and corresponding endpoints use the
term groups.
https://cloud.mongodb.com/api/atlas/v1.0
The Atlas Administration API authenticates using HTTP Digest Authentication. Provide a programmatic API public key and corresponding private key as the username and password when constructing the HTTP request. To learn how to configure API access for an Atlas project, see Get Started with the Atlas Administration API.
Syntax
GET /groups/{GROUP-ID}/alerts/{ALERT-ID}
Request Path Parameters
Parameter | Required/Optional | Description |
|---|---|---|
{GROUP-ID} | Required | Project identifier. |
{ALERT-ID} | Required | Alert identifier. |
Request Query Parameters
This endpoint might use any of the HTTP request query parameters available to all Atlas Administration API resources. All of these are optional.
Name | Type | Necessity | Description | Default | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
pretty | boolean | Optional | Flag indicating whether the response body should be in a
prettyprint format. | false | ||||||
envelope | boolean | Optional | Flag indicating if Atlas should wrap the response in a JSON envelope. This option may be needed for some API clients. These clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. For endpoints that return one result, the response body includes:
| false |
Request Body Parameters
This endpoint does not use HTTP request body parameters.
Response Elements
The fields in the return document depend on the alert type:
Name | Type | Description |
|---|---|---|
acknowledgedUntil | string | Timestamp in ISO 8601 date and time format in UTC through which the alert has been acknowledged.
Returned if the alert has been acknowledged. |
acknowledgementComment | string | Comment left by the user who acknowledged the alert. Returned if
the alert has been acknowledged. |
acknowledgingUsername | string | Username of the user who acknowledged the alert. Returned if the
alert has been acknowledged. |
alertConfigId | string | Unique identifier of the alert configuration that triggered this
alert. |
clusterName | string | Name the cluster to which this alert applies. |
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. |
currentValue.number | number | Value. |
currentValue.units | string | Units for the value. Possible units are:
|
eventTypeName | string | Human-readable label that indicates the type of event. |
id | string | Unique identifier for the alert. |
groupId | string | Unique identifier of the project that this alert was opened for. |
hostnameAndPort | string | Hostname and port of the host to which the alert applies. |
lastNotified | string | Timestamp in ISO 8601 date and time format in UTC when the last notification was sent for this
alert. Returned if notifications have been sent. |
metricName | string | Name of the metric whose value went outside the threshold. To learn more about the available metrics, see Host Metrics. Note If you set |
replicaSetName | string | Name of the replica set, if applicable. |
resolved | string | Timestamp in ISO 8601 date and time format in UTC when the alert was closed. Returned if
"status" : "CLOSED". |
status | string | Current state of the alert. Possible values are:
|
updated | string | Timestamp in ISO 8601 date and time format in UTC when the alert was last updated. |
Serverless Measurements
Metric Name | Description |
|---|---|
SERVERLESS_CONNECTIONS | Number of active connections to the serverless instance
meets the specified average. |
SERVERLESS_CONNECTIONS_PERCENT | Number of open connections to the serverless instance
exceeds the specified percentage threshold. |
SERVERLESS_DATA_SIZE_TOTAL | Approximate size of all documents (and their paddings) meets
the specified threshold. |
SERVERLESS_NETWORK_BYTES_IN | Number of bytes sent to MongoDB meets the specified threshold. |
SERVERLESS_NETWORK_BYTES_OUT | Number of bytes sent from MongoDB meets the specified
threshold. |
SERVERLESS_NETWORK_NUM_REQUESTS | Number of requests sent to MongoDB meets the specified average. |
SERVERLESS_OPCOUNTER_CMD | Rate of commands performed meets the specified threshold. |
SERVERLESS_OPCOUNTER_DELETE | Rate of deletes meets the specified threshold. |
SERVERLESS_OPCOUNTER_GETMORE | Rate of getmore operations to retrieve the next cursor
batch meets the specified threshold. |
SERVERLESS_OPCOUNTER_INSERT | Rate of inserts meets the specified threshold. |
SERVERLESS_OPCOUNTER_QUERY | Rate of queries meets the specified threshold. |
SERVERLESS_OPCOUNTER_UPDATE | Rate of updates meets the specified threshold. |
SERVERLESS_TOTAL_READ_UNITS | Total read units meet the specified threshold. |
Example Request
curl -X GET -u "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest "https://cloud.mongodb.com/api/atlas/v1.0/groups/535683b3794d371327b/alerts/533cb4b8e4b0f1820cdabc7f"
Example Response
{ "alertConfigId" : "5b43d04087d9d6357de591aa", "created" : "2019-07-26T21:12:19Z", "currentValue" : { "number" : 100, "units" : "RAW" }, "eventTypeName" : "OUTSIDE_METRIC_THRESHOLD", "groupId" : "535683b3794d371327b", "hostnameAndPort" : "cluster0-shard-00-00-19mce.mongodb.net:27017", "id" : "533cb4b8e4b0f1820cdabc7f", "lastNotified" : "2019-07-26T21:13:48Z", "metricName" : "CONNECTIONS", "replicaSetName" : "cluster0-shard-0", "resolved" : "2019-07-26T21:13:42Z", "status" : "CLOSED", "typeName" : "HOST_METRIC", "updated" : "2019-07-26T21:13:42Z", "links" : [ ... ] }