Docs Menu

Acknowledge an Alert

On this page

  • Syntax
  • Request Path Parameters
  • Request Query Parameters
  • Request Body Parameters
  • Response Elements
  • Example Request
  • Example Response
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 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.

PATCH /groups/{GROUP-ID}/alerts/{ALERT-ID}
Parameter
Required/Optional
Description
GROUP-ID
Required
Project identifier.
ALERT-ID
Required
Alert identifier.

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:

status
HTTP response code
envelope
Expected response body
false
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.

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:
  • OPEN
  • CLOSED
  • CANCELLED
updated
string
Timestamp in ISO 8601 date and time format in UTC when the alert was last updated.
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."
}'
{
"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
MongoDB logo
© 2021 MongoDB, Inc.

About

  • Careers
  • Legal Notices
  • Privacy Notices
  • Security Information
  • Trust Center
© 2021 MongoDB, Inc.