Acknowledge an Alert¶

Note

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 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 Configure Atlas API Access.

Syntax¶

PATCH /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 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:


status	HTTP response code
envelope	Expected response body

false

Request Body Parameters¶

Field	Required/Optional	Description
`acknowledgedUntil`	Required. To acknowledge an alert "forever", set the field value to 100 years in the future. To unacknowledge a previously acknowledged alert, set the field value to the past.	The page to return.
`acknowledgementComment`	Optional.	If you add a comment, Atlas displays the comment next to the message that the alert has been acknowledged.

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:

RAW
BITS
BYTES
KILOBITS
KILOBYTES
MEGABITS
MEGABYTES
GIGABITS
GIGABYTES
TERABYTES
PETABYTES
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS

eventTypeName

string

Name of the event that triggered the alert.

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.

Possible values are:

ASSERT_MSG
ASSERT_REGULAR
ASSERT_USER
ASSERT_WARNING
AVG_COMMAND_EXECUTION_TIME
AVG_READ_EXECUTION_TIME
AVG_WRITE_EXECUTION_TIME
CACHE_BYTES_READ_INTO
CACHE_BYTES_WRITTEN_FROM
CACHE_DIRTY_BYTES
CACHE_USED_BYTES
COMPUTED_MEMORY
CONNECTIONS
CONNECTIONS_PERCENT
CURSORS_TOTAL_OPEN
CURSORS_TOTAL_TIMED_OUT
DB_DATA_SIZE_TOTAL
DB_INDEX_SIZE_TOTAL
DB_STORAGE_TOTAL
DISK_PARTITION_SPACE_USED_DATA
DISK_PARTITION_SPACE_USED_INDEX
DISK_PARTITION_SPACE_USED_JOURNAL
DISK_PARTITION_UTILIZATION_DATA
DISK_PARTITION_UTILIZATION_INDEX

DISK_PARTITION_UTILIZATION_JOURNAL
DOCUMENT_DELETED
DOCUMENT_INSERTED
DOCUMENT_RETURNED
DOCUMENT_UPDATED
EXTRA_INFO_PAGE_FAULTS
FTS_MEMORY_RESIDENT
FTS_MEMORY_SHARED
FTS_MEMORY_VIRTUAL
FTS_PROCESS_CPU_KERNEL
FTS_PROCESS_CPU_USER
FTS_PROCESS_DISK
GLOBAL_LOCK_CURRENT_QUEUE_READERS
GLOBAL_LOCK_CURRENT_QUEUE_TOTAL
GLOBAL_LOCK_CURRENT_QUEUE_WRITERS
LOGICAL_SIZE
MEMORY_RESIDENT
MEMORY_VIRTUAL
NETWORK_BYTES_IN
NETWORK_BYTES_OUT
NETWORK_NUM_REQUESTS
NORMALIZED_FTS_PROCESS_CPU_KERNEL
NORMALIZED_FTS_PROCESS_CPU_USER
NORMALIZED_SYSTEM_CPU_STEAL

NORMALIZED_SYSTEM_CPU_USER
OPCOUNTER_CMD
OPCOUNTER_DELETE
OPCOUNTER_GETMORE
OPCOUNTER_INSERT
OPCOUNTER_QUERY
OPCOUNTER_REPL_CMD
OPCOUNTER_REPL_DELETE
OPCOUNTER_REPL_INSERT
OPCOUNTER_REPL_UPDATE
OPCOUNTER_UPDATE
OPERATIONS_SCAN_AND_ORDER
OPLOG_MASTER_LAG_TIME_DIFF
OPLOG_MASTER_TIME
OPLOG_RATE_GB_PER_HOUR
OPLOG_SLAVE_LAG_MASTER_TIME
QUERY_EXECUTOR_SCANNED
QUERY_EXECUTOR_SCANNED_OBJECTS
QUERY_TARGETING_SCANNED_OBJECTS_PER_RETURNED
QUERY_TARGETING_SCANNED_PER_RETURNED
RESTARTS_IN_LAST_HOUR
TICKETS_AVAILABLE_READS
TICKETS_AVAILABLE_WRITES

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:

TRACKING
Alert condition exists but hasn't persisted beyond the defined notification delay.
Tip
See also:
Request Query Parameters.
OPEN
CLOSED
CANCELLED

updated

string

Timestamp in ISO 8601 date and time format in UTC when the alert was last updated.

Example Request¶

curl -u "{PUBLIC-KEY}:{PRIVATE-KEY}" -H "Content-Type: application/json" --digest -X PATCH "https://cloud.mongodb.com/api/atlas/v1.0/groups/535683b3794d371327b/alerts/524dc45ee4b835ff81ec2a" --data '
{
  "acknowledgedUntil" : "2016-10-01T00:00:00-0400",
  "acknowledgementComment" : "This is normal. Please ignore."
}'

Example Response¶

{
  "id" : "524dc45ee4b835ff81ec2a",
  "groupId" : "535683b3794d371327b",
  "eventTypeName" : "OUTSIDE_METRIC_THRESHOLD",
  "status" : "OPEN",
  "acknowledgedUntil" : "2016-10-01T04:00:00Z",
  "acknowledgementComment" : "This is normal. Please ignore.",
  "acknowledgingUsername" : "someuser@example.com",
  "created" : "2016-08-23T20:28:14Z",
  "updated" : "2016-08-23T20:33:14Z",
  "lastNotified" : "2016-08-23T20:33:23Z",
  "metricName" : "ASSERTS_REGULAR",
  "currentValue" : {
    "number" : 0.0,
    "units" : "RAW"
  },
  "links" : [ ... ]
}

Give Feedback

← Get an Alert Alert Configurations →