Monitor
Monitor is the Schema for the Monitors API. Provides a Datadog monitor resource. This can be used to create and manage Datadog monitors.
TypeMR
Providerprovider-datadog
Groupdatadog.upbound.io
Scopecluster
Versionv1alpha1

1apiVersion: datadog.upbound.io/v1alpha1

2kind: Monitor

apiVersion
string
kind
string
metadata
object
spec
object

MonitorSpec defines the desired state of Monitor

deletionPolicy
string
forProvider
required
object

(No description available)

enableLogsSample
boolean
escalationMessage
string
evaluationDelay
number
forceDelete
boolean
groupRetentionDuration
string
groupbySimpleMonitor
boolean
includeTags
boolean
locked
boolean
message
string
monitorThresholdWindows
array

(Block List, Max: 1) A mapping containing recovery_window and trigger_window values, e.g. last_15m . Can only be used for, and are required for, anomaly monitors. (see below for nested schema) A mapping containing recovery_window and trigger_window values, e.g. last_15m . Can only be used for, and are required for, anomaly monitors.

recoveryWindow
string
triggerWindow
string
monitorThresholds
array

(Block List, Max: 1) Alert thresholds of the monitor. (see below for nested schema) Alert thresholds of the monitor.

critical
string
criticalRecovery
string
ok
string
unknown
string
warning
string
warningRecovery
string
name
string
newGroupDelay
number
newHostDelay
number
noDataTimeframe
number
notificationPresetName
string
notifyAudit
boolean
notifyBy
array

alert. Controls what granularity a monitor alerts on. Only available for monitors with groupings. For instance, a monitor grouped by cluster, namespace, and pod can be configured to only notify on each new cluster violating the alert conditions by setting notify_by to ['cluster']. Tags mentioned in notify_by must be a subset of the grouping tags in the query. For example, a query grouped by cluster and namespace cannot notify on region. Setting notify_by to [*] configures the monitor to notify as a simple-alert.

notifyNoData
boolean
onMissingData
string
priority
number
query
string
renotifyInterval
number
renotifyOccurrences
number
renotifyStatuses
array

notification messages should be sent. Valid values are alert, warn, no data. The types of statuses for which re-notification messages should be sent. Valid values are alert, warn, no data.

requireFullWindow
boolean
restrictedRoles
array

(Set of String) A list of unique role identifiers to define which roles are allowed to edit the monitor. Editing a monitor includes any updates to the monitor configuration, monitor deletion, and muting of the monitor for any amount of time. Roles unique identifiers can be pulled from the Roles API in the data.id field. A list of unique role identifiers to define which roles are allowed to edit the monitor. Editing a monitor includes any updates to the monitor configuration, monitor deletion, and muting of the monitor for any amount of time. Roles unique identifiers can be pulled from the Roles API in the data.id field.

schedulingOptions
array

(Block List) Configuration options for scheduling. (see below for nested schema) Configuration options for scheduling.

customSchedule
array

(Block List) Configuration options for the custom schedules. If start is omitted, the monitor creation time will be used. (see below for nested schema) Configuration options for the custom schedules. If start is omitted, the monitor creation time will be used.

recurrence
array

(Block List, Min: 1, Max: 1) A list of recurrence definitions. Length must be 1. (see below for nested schema) A list of recurrence definitions. Length must be 1.

rrule
string
start
string
timezone
string
evaluationWindow
array

(Block List) Configuration options for the evaluation window. If hour_starts is set, no other fields may be set. Otherwise, day_starts and month_starts must be set together. (see below for nested schema) Configuration options for the evaluation window. If hour_starts is set, no other fields may be set. Otherwise, day_starts and month_starts must be set together.

dayStarts
string
hourStarts
number
monthStarts
number
tags
array

(Set of String) A list of tags to associate with your monitor. This can help you categorize and filter monitors in the manage monitors page of the UI. Note: it's not currently possible to filter by these tags when querying via the API A list of tags to associate with your monitor. This can help you categorize and filter monitors in the manage monitors page of the UI. Note: it's not currently possible to filter by these tags when querying via the API

timeoutH
number
type
string
validate
boolean
variables
array

(Block List, Max: 1) (see below for nested schema)

eventQuery
array

(Block List) A timeseries formula and functions events query. (see below for nested schema) A timeseries formula and functions events query.

compute
array

(Block List, Min: 1) The compute options. (see below for nested schema) The compute options.

aggregation
string
interval
number
metric
string
dataSource
string
groupBy
array

(Block List) Group by options. (see below for nested schema) Group by options.

facet
string
limit
number
sort
array

(Block List, Max: 1) The options for sorting group by results. (see below for nested schema) The options for sorting group by results.

aggregation
string
metric
string
order
string
indexes
array

(List of String) An array of index names to query in the stream. An array of index names to query in the stream.

name
string
search
array

(Block List, Min: 1, Max: 1) The search options. (see below for nested schema) The search options.

query
string
initProvider
object

THIS IS A BETA FIELD. It will be honored unless the Management Policies feature flag is disabled. InitProvider holds the same fields as ForProvider, with the exception of Identifier and other resource reference fields. The fields that are in InitProvider are merged into ForProvider when the resource is created. The same fields are also added to the terraform ignore_changes hook, to avoid updating them after creation. This is useful for fields that are required on creation, but we do not desire to update them after creation, for example because of an external controller is managing them, like an autoscaler.

enableLogsSample
boolean
escalationMessage
string
evaluationDelay
number
forceDelete
boolean
groupRetentionDuration
string
groupbySimpleMonitor
boolean
includeTags
boolean
locked
boolean
message
string
monitorThresholdWindows
array

(Block List, Max: 1) A mapping containing recovery_window and trigger_window values, e.g. last_15m . Can only be used for, and are required for, anomaly monitors. (see below for nested schema) A mapping containing recovery_window and trigger_window values, e.g. last_15m . Can only be used for, and are required for, anomaly monitors.

recoveryWindow
string
triggerWindow
string
monitorThresholds
array

(Block List, Max: 1) Alert thresholds of the monitor. (see below for nested schema) Alert thresholds of the monitor.

critical
string
criticalRecovery
string
ok
string
unknown
string
warning
string
warningRecovery
string
name
string
newGroupDelay
number
newHostDelay
number
noDataTimeframe
number
notificationPresetName
string
notifyAudit
boolean
notifyBy
array

alert. Controls what granularity a monitor alerts on. Only available for monitors with groupings. For instance, a monitor grouped by cluster, namespace, and pod can be configured to only notify on each new cluster violating the alert conditions by setting notify_by to ['cluster']. Tags mentioned in notify_by must be a subset of the grouping tags in the query. For example, a query grouped by cluster and namespace cannot notify on region. Setting notify_by to [*] configures the monitor to notify as a simple-alert.

notifyNoData
boolean
onMissingData
string
priority
number
query
string
renotifyInterval
number
renotifyOccurrences
number
renotifyStatuses
array

notification messages should be sent. Valid values are alert, warn, no data. The types of statuses for which re-notification messages should be sent. Valid values are alert, warn, no data.

requireFullWindow
boolean
restrictedRoles
array

(Set of String) A list of unique role identifiers to define which roles are allowed to edit the monitor. Editing a monitor includes any updates to the monitor configuration, monitor deletion, and muting of the monitor for any amount of time. Roles unique identifiers can be pulled from the Roles API in the data.id field. A list of unique role identifiers to define which roles are allowed to edit the monitor. Editing a monitor includes any updates to the monitor configuration, monitor deletion, and muting of the monitor for any amount of time. Roles unique identifiers can be pulled from the Roles API in the data.id field.

schedulingOptions
array

(Block List) Configuration options for scheduling. (see below for nested schema) Configuration options for scheduling.

customSchedule
array

(Block List) Configuration options for the custom schedules. If start is omitted, the monitor creation time will be used. (see below for nested schema) Configuration options for the custom schedules. If start is omitted, the monitor creation time will be used.

recurrence
array

(Block List, Min: 1, Max: 1) A list of recurrence definitions. Length must be 1. (see below for nested schema) A list of recurrence definitions. Length must be 1.

rrule
string
start
string
timezone
string
evaluationWindow
array

(Block List) Configuration options for the evaluation window. If hour_starts is set, no other fields may be set. Otherwise, day_starts and month_starts must be set together. (see below for nested schema) Configuration options for the evaluation window. If hour_starts is set, no other fields may be set. Otherwise, day_starts and month_starts must be set together.

dayStarts
string
hourStarts
number
monthStarts
number
tags
array

(Set of String) A list of tags to associate with your monitor. This can help you categorize and filter monitors in the manage monitors page of the UI. Note: it's not currently possible to filter by these tags when querying via the API A list of tags to associate with your monitor. This can help you categorize and filter monitors in the manage monitors page of the UI. Note: it's not currently possible to filter by these tags when querying via the API

timeoutH
number
type
string
validate
boolean
variables
array

(Block List, Max: 1) (see below for nested schema)

eventQuery
array

(Block List) A timeseries formula and functions events query. (see below for nested schema) A timeseries formula and functions events query.

compute
array

(Block List, Min: 1) The compute options. (see below for nested schema) The compute options.

aggregation
string
interval
number
metric
string
dataSource
string
groupBy
array

(Block List) Group by options. (see below for nested schema) Group by options.

facet
string
limit
number
sort
array

(Block List, Max: 1) The options for sorting group by results. (see below for nested schema) The options for sorting group by results.

aggregation
string
metric
string
order
string
indexes
array

(List of String) An array of index names to query in the stream. An array of index names to query in the stream.

name
string
search
array

(Block List, Min: 1, Max: 1) The search options. (see below for nested schema) The search options.

query
string
managementPolicies
array

THIS IS A BETA FIELD. It is on by default but can be opted out through a Crossplane feature flag. ManagementPolicies specify the array of actions Crossplane is allowed to take on the managed and external resources. This field is planned to replace the DeletionPolicy field in a future release. Currently, both could be set independently and non-default values would be honored if the feature flag is enabled. If both are custom, the DeletionPolicy field will be ignored. See the design doc for more information: https://github.com/crossplane/crossplane/blob/499895a25d1a1a0ba1604944ef98ac7a1a71f197/design/design-doc-observe-only-resources.md?plain=1#L223 and this one: https://github.com/crossplane/crossplane/blob/444267e84783136daa93568b364a5f01228cacbe/design/one-pager-ignore-changes.md

providerConfigRef
object

ProviderConfigReference specifies how the provider that will be used to create, observe, update, and delete this managed resource should be configured.

name
required
string
policy
object

Policies for referencing.

resolution
string
resolve
string
publishConnectionDetailsTo
object

PublishConnectionDetailsTo specifies the connection secret config which contains a name, metadata and a reference to secret store config to which any connection details for this managed resource should be written. Connection details frequently include the endpoint, username, and password required to connect to the managed resource.

configRef
object

SecretStoreConfigRef specifies which secret store config should be used for this ConnectionSecret.

name
required
string
policy
object

Policies for referencing.

resolution
string
resolve
string
metadata
object

Metadata is the metadata for connection secret.

annotations
object
labels
object
type
string
name
required
string
writeConnectionSecretToRef
object

WriteConnectionSecretToReference specifies the namespace and name of a Secret to which any connection details for this managed resource should be written. Connection details frequently include the endpoint, username, and password required to connect to the managed resource. This field is planned to be replaced in a future release in favor of PublishConnectionDetailsTo. Currently, both could be set independently and connection details would be published to both without affecting each other.

name
required
string
namespace
required
string
status
object

MonitorStatus defines the observed state of Monitor.

atProvider
object

(No description available)

enableLogsSample
boolean
enableSamples
boolean
escalationMessage
string
evaluationDelay
number
forceDelete
boolean
groupRetentionDuration
string
groupbySimpleMonitor
boolean
id
string
includeTags
boolean
locked
boolean
message
string
monitorThresholdWindows
array

(Block List, Max: 1) A mapping containing recovery_window and trigger_window values, e.g. last_15m . Can only be used for, and are required for, anomaly monitors. (see below for nested schema) A mapping containing recovery_window and trigger_window values, e.g. last_15m . Can only be used for, and are required for, anomaly monitors.

recoveryWindow
string
triggerWindow
string
monitorThresholds
array

(Block List, Max: 1) Alert thresholds of the monitor. (see below for nested schema) Alert thresholds of the monitor.

critical
string
criticalRecovery
string
ok
string
unknown
string
warning
string
warningRecovery
string
name
string
newGroupDelay
number
newHostDelay
number
noDataTimeframe
number
notificationPresetName
string
notifyAudit
boolean
notifyBy
array

alert. Controls what granularity a monitor alerts on. Only available for monitors with groupings. For instance, a monitor grouped by cluster, namespace, and pod can be configured to only notify on each new cluster violating the alert conditions by setting notify_by to ['cluster']. Tags mentioned in notify_by must be a subset of the grouping tags in the query. For example, a query grouped by cluster and namespace cannot notify on region. Setting notify_by to [*] configures the monitor to notify as a simple-alert.

notifyNoData
boolean
onMissingData
string
priority
number
query
string
renotifyInterval
number
renotifyOccurrences
number
renotifyStatuses
array

notification messages should be sent. Valid values are alert, warn, no data. The types of statuses for which re-notification messages should be sent. Valid values are alert, warn, no data.

requireFullWindow
boolean
restrictedRoles
array

(Set of String) A list of unique role identifiers to define which roles are allowed to edit the monitor. Editing a monitor includes any updates to the monitor configuration, monitor deletion, and muting of the monitor for any amount of time. Roles unique identifiers can be pulled from the Roles API in the data.id field. A list of unique role identifiers to define which roles are allowed to edit the monitor. Editing a monitor includes any updates to the monitor configuration, monitor deletion, and muting of the monitor for any amount of time. Roles unique identifiers can be pulled from the Roles API in the data.id field.

schedulingOptions
array

(Block List) Configuration options for scheduling. (see below for nested schema) Configuration options for scheduling.

customSchedule
array

(Block List) Configuration options for the custom schedules. If start is omitted, the monitor creation time will be used. (see below for nested schema) Configuration options for the custom schedules. If start is omitted, the monitor creation time will be used.

recurrence
array

(Block List, Min: 1, Max: 1) A list of recurrence definitions. Length must be 1. (see below for nested schema) A list of recurrence definitions. Length must be 1.

rrule
string
start
string
timezone
string
evaluationWindow
array

(Block List) Configuration options for the evaluation window. If hour_starts is set, no other fields may be set. Otherwise, day_starts and month_starts must be set together. (see below for nested schema) Configuration options for the evaluation window. If hour_starts is set, no other fields may be set. Otherwise, day_starts and month_starts must be set together.

dayStarts
string
hourStarts
number
monthStarts
number
tags
array

(Set of String) A list of tags to associate with your monitor. This can help you categorize and filter monitors in the manage monitors page of the UI. Note: it's not currently possible to filter by these tags when querying via the API A list of tags to associate with your monitor. This can help you categorize and filter monitors in the manage monitors page of the UI. Note: it's not currently possible to filter by these tags when querying via the API

timeoutH
number
type
string
validate
boolean
variables
array

(Block List, Max: 1) (see below for nested schema)

eventQuery
array

(Block List) A timeseries formula and functions events query. (see below for nested schema) A timeseries formula and functions events query.

compute
array

(Block List, Min: 1) The compute options. (see below for nested schema) The compute options.

aggregation
string
interval
number
metric
string
dataSource
string
groupBy
array

(Block List) Group by options. (see below for nested schema) Group by options.

facet
string
limit
number
sort
array

(Block List, Max: 1) The options for sorting group by results. (see below for nested schema) The options for sorting group by results.

aggregation
string
metric
string
order
string
indexes
array

(List of String) An array of index names to query in the stream. An array of index names to query in the stream.

name
string
search
array

(Block List, Min: 1, Max: 1) The search options. (see below for nested schema) The search options.

query
string
conditions
array

Conditions of the resource.

lastTransitionTime
required
string
message
string
reason
required
string
status
required
string
type
required
string
Discover the building blocks for your internal cloud platform.
© 2026 Upbound, Inc.
Solutions
Learn
Company
Community
More