Navigation

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.

Base URL: https://cloud.mongodb.com/api/atlas/v1.0

The Atlas API uses HTTP Digest Authentication. Provide a programmatic API public key and corresponding private key as the username and password when constructing the HTTP request.

For complete documentation on configuring API access for an Atlas project, see Configure Atlas API Access.

Syntax

PATCH /api/atlas/v1.0/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

The following query parameters are optional:

Name Type Description Default
pageNum integer Page number (1-based). 1
itemsPerPage integer Number of items to return per page, up to a maximum of 500. 100
pretty boolean Displays response in a prettyprint format. false
envelope boolean Specifies whether or not to wrap the response in an envelope. 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.

  • 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" : [ ... ]
}