Type object
Schema URL https://catalog.lintel.tools/schemas/schemastore/serverless-framework-configuration/_shared/latest--mongodb-atlas-alertconfiguration.json
Parent schema serverless-framework-configuration
Type: object

Returns and edits the conditions that trigger alerts and how MongoDB Cloud notifies users. This collection remains under revision and may change. Refer to the legacy documentation for this collection in the following link.. Source:- https://github.com/aws-cloudformation/aws-cloudformation-rpdk.git

Properties

Profile string | Aws_CF_FunctionString

Profile used to provide credentials information, (a secret with the cfn/atlas/profile/{Profile}, is required), if not provided default is used

EventTypeName string | Aws_CF_FunctionString

Event type that triggers an alert.

ProjectId string | Aws_CF_FunctionString

Unique 24-hexadecimal digit string that identifies your project.

Matchers object[]

List of rules that determine whether MongoDB Cloud checks an object for the alert configuration. You can filter using the matchers array if the eventTypeName specifies an event for a host, replica set, or sharded cluster.

MetricThreshold object
5 nested properties
MetricName string | Aws_CF_FunctionString

Human-readable label that identifies the metric against which MongoDB Cloud checks the configured metricThreshold.threshold.

Mode string | Aws_CF_FunctionString

MongoDB Cloud computes the current metric value as an average.

Operator string | Aws_CF_FunctionString

Comparison operator to apply when checking the current metric value.

Threshold number

Value of metric that, when exceeded, triggers an alert.

Units string | Aws_CF_FunctionString

Element used to express the quantity. This can be an element of time, storage capacity, and the like.

Notifications object[]

List that contains the targets that MongoDB Cloud sends notifications.

Threshold object
3 nested properties
Operator string | Aws_CF_FunctionString

Comparison operator to apply when checking the current metric value.

Threshold number

Value of metric that, when exceeded, triggers an alert.

Units string | Aws_CF_FunctionString

Element used to express the quantity. This can be an element of time, storage capacity, and the like.

TypeName string | Aws_CF_FunctionString

Human-readable label that displays the alert type.

Definitions

AlertConfigView object
Created string | Aws_CF_FunctionString

Date and time when MongoDB Cloud created the alert configuration. This parameter expresses its value in the ISO 8601 timestamp format in UTC.

Enabled boolean

Flag that indicates whether someone enabled this alert configuration for the specified project.

EventTypeName string | Aws_CF_FunctionString

Event type that triggers an alert.

GroupId string | Aws_CF_FunctionString

Unique 24-hexadecimal digit string that identifies the project that owns this alert configuration.

Id string | Aws_CF_FunctionString

Unique 24-hexadecimal digit string that identifies this alert configuration.

Links object[]

List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships.

Matchers object[]

List of rules that determine whether MongoDB Cloud checks an object for the alert configuration. You can filter using the matchers array if the eventTypeName specifies an event for a host, replica set, or sharded cluster.

MetricThreshold object
5 nested properties
MetricName string | Aws_CF_FunctionString

Human-readable label that identifies the metric against which MongoDB Cloud checks the configured metricThreshold.threshold.

Mode string | Aws_CF_FunctionString

MongoDB Cloud computes the current metric value as an average.

Operator string | Aws_CF_FunctionString

Comparison operator to apply when checking the current metric value.

Threshold number

Value of metric that, when exceeded, triggers an alert.

Units string | Aws_CF_FunctionString

Element used to express the quantity. This can be an element of time, storage capacity, and the like.

Notifications object[]

List that contains the targets that MongoDB Cloud sends notifications.

Threshold object
3 nested properties
Operator string | Aws_CF_FunctionString

Comparison operator to apply when checking the current metric value.

Threshold number

Value of metric that, when exceeded, triggers an alert.

Units string | Aws_CF_FunctionString

Element used to express the quantity. This can be an element of time, storage capacity, and the like.

TypeName string | Aws_CF_FunctionString

Human-readable label that displays the alert type.

Updated string | Aws_CF_FunctionString

Date and time when someone last updated this alert configuration. This parameter expresses its value in the ISO 8601 timestamp format in UTC.

AlertView object
AcknowledgedUntil string | Aws_CF_FunctionString

Date and time until which this alert has been acknowledged. This parameter expresses its value in the ISO 8601 timestamp format in UTC. The resource returns this parameter if a MongoDB User previously acknowledged this alert.

  • To acknowledge this alert forever, set the parameter value to 100 years in the future.

  • To unacknowledge a previously acknowledged alert, set the parameter value to a date in the past.

AcknowledgementComment string | Aws_CF_FunctionString

Comment that a MongoDB Cloud user submitted when acknowledging the alert.

AcknowledgingUsername string | Aws_CF_FunctionString

MongoDB Cloud username of the person who acknowledged the alert. The response returns this parameter if a MongoDB Cloud user previously acknowledged this alert.

AlertConfigId string | Aws_CF_FunctionString

Unique 24-hexadecimal digit string that identifies the alert configuration that sets this alert.

ClusterName string | Aws_CF_FunctionString

Human-readable label that identifies the cluster to which this alert applies. This resource returns this parameter for alerts of events impacting backups, replica sets, or sharded clusters.

Created string | Aws_CF_FunctionString

Date and time when MongoDB Cloud created this alert. This parameter expresses its value in the ISO 8601 timestamp format in UTC.

CurrentValue object
2 nested properties
Number number

Amount of the metricName recorded at the time of the event. This value triggered the alert.

Units string | Aws_CF_FunctionString

Element used to express the quantity in currentValue.number. This can be an element of time, storage capacity, and the like. This metric triggered the alert.

EventTypeName string | Aws_CF_FunctionString

Incident that triggered this alert.

GroupId string | Aws_CF_FunctionString

Unique 24-hexadecimal digit string that identifies the project that owns this alert.

HostnameAndPort string | Aws_CF_FunctionString

Hostname and port of the host to which this alert applies. The resource returns this parameter for alerts of events impacting hosts or replica sets.

Id string | Aws_CF_FunctionString

Unique 24-hexadecimal digit string that identifies this alert.

LastNotified string | Aws_CF_FunctionString

Date and time that any notifications were last sent for this alert. This parameter expresses its value in the ISO 8601 timestamp format in UTC. The resource returns this parameter if MongoDB Cloud has sent notifications for this alert.

Links object[]

List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships.

MetricName string | Aws_CF_FunctionString

Human-readable label that identifies the metric against which MongoDB Cloud checks the alert.

ReplicaSetName string | Aws_CF_FunctionString

Name of the replica set to which this alert applies. The response returns this parameter for alerts of events impacting backups, hosts, or replica sets.

Resolved string | Aws_CF_FunctionString

Date and time that this alert changed to '"status" : "CLOSED"'. This parameter expresses its value in the ISO 8601 timestamp format in UTC. The resource returns this parameter once '"status" : "CLOSED"'.

Status string | Aws_CF_FunctionString

State of this alert at the time you requested its details.

TypeName string | Aws_CF_FunctionString

Category in which MongoDB Cloud classifies this alert.

Updated string | Aws_CF_FunctionString

Date and time when someone last updated this alert. This parameter expresses its value in the ISO 8601 timestamp format in UTC.

IntegerThresholdView object
Operator string | Aws_CF_FunctionString

Comparison operator to apply when checking the current metric value.

Threshold number

Value of metric that, when exceeded, triggers an alert.

Units string | Aws_CF_FunctionString

Element used to express the quantity. This can be an element of time, storage capacity, and the like.

Matcher object
FieldName string | Aws_CF_FunctionString

Name of the parameter in the target object that MongoDB Cloud checks. The parameter must match all rules for MongoDB Cloud to check for alert configurations.

Operator string | Aws_CF_FunctionString

Comparison operator to apply when checking the current metric value against matcher[n].value.

Value string | Aws_CF_FunctionString

Value to match or exceed using the specified matchers.operator.

MetricThresholdView object
MetricName string | Aws_CF_FunctionString

Human-readable label that identifies the metric against which MongoDB Cloud checks the configured metricThreshold.threshold.

Mode string | Aws_CF_FunctionString

MongoDB Cloud computes the current metric value as an average.

Operator string | Aws_CF_FunctionString

Comparison operator to apply when checking the current metric value.

Threshold number

Value of metric that, when exceeded, triggers an alert.

Units string | Aws_CF_FunctionString

Element used to express the quantity. This can be an element of time, storage capacity, and the like.

NotificationView object
ApiToken string | Aws_CF_FunctionString

Slack API token or Bot token that MongoDB Cloud needs to send alert notifications via Slack. The resource requires this parameter when '"notifications.typeName" : "SLACK"'. If the token later becomes invalid, MongoDB Cloud sends an email to the project owners. If the token remains invalid, MongoDB Cloud removes the token.

ChannelName string | Aws_CF_FunctionString

Name of the Slack channel to which MongoDB Cloud sends alert notifications. The resource requires this parameter when '"notifications.typeName" : "SLACK"'.

DatadogApiKey string | Aws_CF_FunctionString

Datadog API Key that MongoDB Cloud needs to send alert notifications to Datadog. You can find this API key in the Datadog dashboard. The resource requires this parameter when '"notifications.typeName" : "DATADOG"'.

DatadogRegion string | Aws_CF_FunctionString

Datadog region that indicates which API Uniform Resource Locator (URL) to use. The resource requires this parameter when '"notifications.typeName" : "DATADOG"'.

DelayMin number

Number of minutes that MongoDB Cloud waits after detecting an alert condition before it sends out the first notification.

EmailAddress string | Aws_CF_FunctionString

Email address to which MongoDB Cloud sends alert notifications. The resource requires this parameter when '"notifications.typeName" : "EMAIL"'. You don't need to set this value to send emails to individual or groups of MongoDB Cloud users including:

  • specific MongoDB Cloud users ('"notifications.typeName" : "USER"')
  • MongoDB Cloud users with specific project roles ('"notifications.typeName" : "GROUP"')
  • MongoDB Cloud users with specific organization roles ('"notifications.typeName" : "ORG"')
  • MongoDB Cloud teams ('"notifications.typeName" : "TEAM"')

To send emails to one MongoDB Cloud user or grouping of users, set the notifications.emailEnabled parameter.

EmailEnabled boolean

Flag that indicates whether MongoDB Cloud should send email notifications. The resource requires this parameter when one of the following values have been set:

  • '"notifications.typeName" : "ORG"'
  • '"notifications.typeName" : "GROUP"'
  • '"notifications.typeName" : "USER"'
FlowName string | Aws_CF_FunctionString

Flowdock flow name to which MongoDB Cloud sends alert notifications. This name appears after the organization name in the Uniform Resource Locator (URL) path: 'www.flowdock.com/app//'. The resource requires this parameter when '"notifications.typeName" : "FLOWDOCK"'.

FlowdockApiToken string | Aws_CF_FunctionString

Flowdock API token that MongoDB Cloud needs to send alert notifications to Flowdock. The resource requires this parameter when '"notifications.typeName" : "FLOWDOCK"'. If the token later becomes invalid, MongoDB Cloud sends an email to the project owners. If the token remains invalid, MongoDB Cloud removes the token.

IntervalMin number

Number of minutes to wait between successive notifications. MongoDB Cloud sends notifications until someone acknowledges the unacknowledged alert.

PagerDuty, VictorOps, and OpsGenie notifications don't return this element. Configure and manage the notification interval within each of those services.

MicrosoftTeamsWebhookUrl string | Aws_CF_FunctionString

Microsoft Teams Webhook Uniform Resource Locator (URL) that MongoDB Cloud needs to send this notification via Microsoft Teams. The resource requires this parameter when '"notifications.typeName" : "MICROSOFT_TEAMS"'. If the URL later becomes invalid, MongoDB Cloud sends an email to the project owners. If the key remains invalid, MongoDB Cloud removes it.

MobileNumber string | Aws_CF_FunctionString

Mobile phone number to which MongoDB Cloud sends alert notifications. The resource requires this parameter when '"notifications.typeName" : "SMS"'.

NotificationToken string | Aws_CF_FunctionString

HipChat API token that MongoDB Cloud needs to send alert notifications to HipChat. The resource requires this parameter when '"notifications.typeName" : "HIP_CHAT"'". If the token later becomes invalid, MongoDB Cloud sends an email to the project owners. If the token remains invalid, MongoDB Cloud removes it.

OpsGenieApiKey string | Aws_CF_FunctionString

API Key that MongoDB Cloud needs to send this notification via Opsgenie. The resource requires this parameter when '"notifications.typeName" : "OPS_GENIE"'. If the key later becomes invalid, MongoDB Cloud sends an email to the project owners. If the key remains invalid, MongoDB Cloud removes it.

OpsGenieRegion string | Aws_CF_FunctionString

Opsgenie region that indicates which API Uniform Resource Locator (URL) to use.

OrgName string | Aws_CF_FunctionString

Flowdock organization name to which MongoDB Cloud sends alert notifications. This name appears after 'www.flowdock.com/app/' in the Uniform Resource Locator (URL) path. The resource requires this parameter when '"notifications.typeName" : "FLOWDOCK"'.

Roles string[]

List that contains the one or more organization or project roles that receive the configured alert. The resource requires this parameter when '"notifications.typeName" : "GROUP"' or '"notifications.typeName" : "ORG"'. If you include this parameter, MongoDB Cloud sends alerts only to users assigned the roles you specify in the array. If you omit this parameter, MongoDB Cloud sends alerts to users assigned any role.

RoomName string | Aws_CF_FunctionString

HipChat API room name to which MongoDB Cloud sends alert notifications. The resource requires this parameter when '"notifications.typeName" : "HIP_CHAT"'".

ServiceKey string | Aws_CF_FunctionString

PagerDuty service key that MongoDB Cloud needs to send notifications via PagerDuty. The resource requires this parameter when '"notifications.typeName" : "PAGER_DUTY"'. If the key later becomes invalid, MongoDB Cloud sends an email to the project owners. If the key remains invalid, MongoDB Cloud removes it.

Severity string | Aws_CF_FunctionString

Degree of seriousness given to this notification.

SmsEnabled boolean

Flag that indicates whether MongoDB Cloud should send text message notifications. The resource requires this parameter when one of the following values have been set:

  • '"notifications.typeName" : "ORG"'
  • '"notifications.typeName" : "GROUP"'
  • '"notifications.typeName" : "USER"'
TeamId string | Aws_CF_FunctionString

Unique 24-hexadecimal digit string that identifies one MongoDB Cloud team. The resource requires this parameter when '"notifications.typeName" : "TEAM"'.

TeamName string | Aws_CF_FunctionString

Name of the MongoDB Cloud team that receives this notification. The resource requires this parameter when '"notifications.typeName" : "TEAM"'.

TypeName string | Aws_CF_FunctionString

Human-readable label that displays the alert notification type.

Username string | Aws_CF_FunctionString

MongoDB Cloud username of the person to whom MongoDB Cloud sends notifications. Specify only MongoDB Cloud users who belong to the project that owns the alert configuration. The resource requires this parameter when '"notifications.typeName" : "USER"'.

VictorOpsApiKey string | Aws_CF_FunctionString

API key that MongoDB Cloud needs to send alert notifications to Splunk On-Call. The resource requires this parameter when '"notifications.typeName" : "VICTOR_OPS"'. If the key later becomes invalid, MongoDB Cloud sends an email to the project owners. If the key remains invalid, MongoDB Cloud removes it.

VictorOpsRoutingKey string | Aws_CF_FunctionString

Routing key that MongoDB Cloud needs to send alert notifications to Splunk On-Call. The resource requires this parameter when '"notifications.typeName" : "VICTOR_OPS"'. If the key later becomes invalid, MongoDB Cloud sends an email to the project owners. If the key remains invalid, MongoDB Cloud removes it.

WebhookSecret string | Aws_CF_FunctionString

An optional field for your webhook secret.

WebhookUrl string | Aws_CF_FunctionString

Your webhook URL.

CurrentValue object
Number number

Amount of the metricName recorded at the time of the event. This value triggered the alert.

Units string | Aws_CF_FunctionString

Element used to express the quantity in currentValue.number. This can be an element of time, storage capacity, and the like. This metric triggered the alert.